Developed with AI assistance (glm-5.3-flash & deepseek-v4.1-flash). · 本插件在 AI（glm-5.3-flash & deepseek-v4.1-flash）辅助下编写。中文说明在下方。

Editor Breadcrumbs

VS Code style breadcrumbs for the Obsidian editor:

Folder › Subfolder › Note name › Heading 1 › Heading 2 › Heading 3 › …

A breadcrumb bar sits at the top of the editor pane, following the cursor (edit mode) or the scroll position (reading mode), and shows the current heading chain only — one crumb per heading level.

Requires Obsidian 1.13.0+, desktop.

Not affiliated with Breadcrumbs. This is an independent plugin and is not related to, endorsed by, or derived from the Breadcrumbs plugin.

Features

Real-time trail: follows the cursor in edit mode, follows scrolling in reading mode — in reading mode the current heading is the one at the middle of the view. Works on long, virtualized documents.
Skipped heading levels stay visible (issue #1): when the structure jumps, e.g. H1 straight to H4, the bar shows extra separators (H1 text ›› H4 text), one per missing level.
Left-click a heading crumb → the sibling heading menu (headings of the same level under the same parent, current one checked). Arrow-key navigation is built in.
Right-click a heading crumb → jump to it immediately.
Jumps land precisely in both modes; reading-mode jumps center the target and use Obsidian's own internal heading-scroll path.
Click a file/folder crumb → reveal the file in the file explorer.
Long names are truncated with an ellipsis in the bar; the sibling menu always shows full titles.

Usage

Action	Effect
Left-click a heading crumb	Sibling heading menu — pick one to jump
Right-click a heading crumb	Jump to that heading immediately
Left/right-click a file or folder crumb	Reveal the file in the file explorer

Settings

Setting	Default	Description
Show folder path	on	Show the `Folder › Subfolder` chain before the file name
Show file name	on	Show the file name crumb
Max characters per crumb	20	Truncation length for the bar (menu entries are never truncated)
Show in reading mode	on	Also show the bar in reading mode, following the scroll position
Hide when there are no headings	off	Hide the bar entirely for notes without headings

Installation

Editor Breadcrumbs is available in the official community plugin store: open the store page or search "Editor Breadcrumbs" in Settings → Community plugins → Browse, then hit Install.

Option A — Download the pre-built files (no build needed)

Download these three files: main.js, manifest.json, styles.css (from the repository root or the Releases page), and copy them into:

<vault>/.obsidian/plugins/editor-breadcrumbs/

Create the folder by yourself. Then in Obsidian: Settings → Community plugins → enable "Editor Breadcrumbs" (turn off Restricted mode first if prompted).

Option B — Install via BRAT

Install BRAT, then add this repository as a BRAT plugin.

Option C — Build from source

Requires Node.js and pnpm.

git clone <this repository>
cd obsidian-editor-breadcrumbs
pnpm install
pnpm build        # produces main.js
npx tsc --noEmit  # optional: type check

Then copy the three files (main.js, manifest.json, styles.css) into <vault>/.obsidian/plugins/editor-breadcrumbs/ as in Option A.