Navigate Headings

approved

by rumcajsev

This plugin has not been manually reviewed by Obsidian staff. Navigate markdown file headings and their structure directly in the file explorer.

1 stars85 downloadsUpdated 26d agoMIT
Navigate Headings Demo

Navigate Headings

See and jump between all your file headings directly in the explorer. No more switching tabs to check your document structure.

Why Use It

  • Navigate documents without leaving the file explorer
  • Jump to any section with one click
  • See your current position as you scroll
  • Works with your existing Obsidian setup

How to Use

  • Click a file title — expands its headings automatically, down to the level set in Auto-expand down to. If that setting is Nothing, clicking the title just opens the file with no expansion.
  • Click the arrow next to a file — always toggles the headings panel regardless of the auto-expand setting. Expands either all levels or just the top level depending on the Arrow expands setting.
  • Click a heading — jumps to that section in the editor. If the heading has children, it also toggles them open/closed.

Settings

SettingDefaultDescription
Show headings up toH3The maximum heading depth shown in the explorer. Headings deeper than this are never displayed.
Auto-expand down toH2How deep the panel opens when you click a file title or switch to a file. Nothing disables automatic expansion entirely — only the arrow will open the panel.
Arrow expandsAll levelsControls what happens when you click the arrow next to a file. All levels opens every heading at once. Next level only shows just the top-level headings and lets you expand deeper sections manually.
Highlight active headingOnHighlights the heading in the explorer that matches your current scroll position in the editor.

Installation

  1. Download the latest release from GitHub
  2. Extract the folder into .obsidian/plugins/ in your vault
  3. Reload Obsidian (Cmd+R or restart)
  4. Enable the plugin in Settings → Community Plugins

That's it! Enjoy navigating your documents.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.