Better Quick Switcher

Quick heading navigation for Obsidian. Search and jump to any heading across your vault.

Features

• Fuzzy heading search — type to find any heading in any file
• Two search modes — search all vault files, or only the current file
• Heading level filters — toggle which heading levels (H1–H6) appear in results
• Folder exclusions — hide results from specific folders
• Result limit — cap the number of suggestions shown

Usage

Press Ctrl+Shift+O (or Cmd+Shift+O on macOS) to open the heading switcher.

• Type to fuzzy-search headings across your vault
• Click All files / Current file to switch search scope
• Press Enter to jump to the selected heading, or click it

Commands

Command	Description	Default Hotkey
heading-switcher:open	Open heading switcher	Ctrl+Shift+O
switcher:open	Override built-in quick switcher	—

Settings

Available in the plugin settings tab:

• Heading Levels — enable or disable individual heading levels (H1–H6)
• Exclude Folders — add folder paths to hide from results
• Max Results — set the maximum number of suggestions (10–200, default 50)

Installation

From Obsidian Community Plugins

1. Open Settings → Community Plugins
2. Click Browse and search for "Better Quick Switcher"
3. Install and enable

Manual

1. Download the latest release from GitHub Releases
2. Copy main.js, manifest.json, and styles.css into Vault/.obsidian/plugins/better-quick-switcher/
3. Enable the plugin in Settings → Community Plugins

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Dev mode (auto-rebuild)
npm run dev

License

MIT