Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Graph Depth Gradient

Jeonghyeon ParkJeonghyeon Park161 downloads

Color graph nodes by hop distance from the active note, as a gradient between two colors.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates3

An Obsidian plugin that colors graph view nodes by their folder depth, as a gradient between two colors — applied independently per top-level section, so each section's root note looks one color and its deepest notes fade toward another. Defaults to a neutral (achromatic) gradient.

Graph view colored by folder depth, each top-level section fading from the start color at its root to the end color at its deepest notes

How depth is measured

Each node is colored by how deep its file sits in the folder tree — simply the number of parent folders in its path:

  • note.md → depth 0
  • area/note.md → depth 1
  • area/topic/sub/note.md → depth 3

The gradient is applied per top-level section (the first folder in the path). Within each section the depth range is detected dynamically: the shallowest note (the section's root) gets the start color, the deepest descendant gets the end color, and depths in between are interpolated linearly. So every section spans the full start→end range regardless of how deep it actually goes — a shallow section like 블로그/ still fades all the way from start to end, and a deep section like 개발/ distributes the gradient across more levels. Files at the vault root (depth 0, no folder) form their own section and take the start color. Notes that aren't files in the vault (tags, attachments-less/unresolved nodes) keep their original color.

This is stable and independent of which note is selected — the coloring reflects your folder structure, not the active note.

How the color is applied

The plugin sets each node's color on the graph renderer directly and refreshes when the vault changes.

Because it overrides node colors, this plugin is mutually exclusive with other graph node-coloring plugins (including Obsidian's Graph color groups for the affected nodes, and any other recoloring plugin). A graph node can only hold one color at a time, so run one coloring scheme at a time. It does not conflict with non-coloring plugins (panning, layout, etc.). Disabling the plugin restores the original colors.

Works in both the global Graph view and the Local graph.

Settings

  • Start color (section root) — color for each section's shallowest note (its root). Default: achromatic (white).
  • End color (deepest) — color for each section's deepest note. Default: achromatic (dark gray).

Notes

This plugin draws into the graph view's internal renderer (setting per-node colors). It relies on internal renderer APIs that are not part of the public plugin API and may change in future Obsidian versions. It is desktop-only.

License

MIT

HealthExcellent
ReviewPassed
About
Color graph view nodes by folder depth using a gradient between two colors. Map depth 0 to the start color and the configured max depth (and deeper) to the end color, with intermediate depths interpolated. Override other node-coloring schemes and work in Global and Local graph (desktop-only).
VisualizationAppearanceFiles
Details
Current version
0.2.1
Last updated
Last month
Created
Last month
Updates
3 releases
Downloads
161
Compatible with
Obsidian 1.4.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
Jeonghyeon ParkJeonghyeon Parkjunghyunbak
GitHubjunghyunbak
  1. Community
  2. Plugins
  3. Visualization
  4. Graph Depth Gradient

Related plugins

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Minimal Theme Settings

Control the colors and fonts in Minimal Theme.

Hider

Hide interface elements such as tooltips, status bar, titlebar, and more.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Advanced URI

Control everything with URI.

Local REST API with MCP

Unlock your automation needs by interacting with your notes over a secure REST API.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.