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

Heading Helper

sidkhuntiasidkhuntia835 downloads

Cycle heading levels and display visual heading indicators in the gutter.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates4

A simple plugin that makes working with headings in Obsidian faster and more visual.

Features

  • Visual heading indicators - See H1, H2, H3, etc. markers in the editor gutter
  • Quick heading changes - Click gutter markers to change heading levels
  • Keyboard commands - Cycle heading levels up/down or set specific levels
  • Smart hierarchy - Warns about heading structure issues (optional)

Usage

Gutter Markers

  • Heading markers (H1, H2, H3, etc.) appear in the gutter next to each heading
  • Click any marker to open a menu and change the heading level
  • Markers are color-coded by importance (H1/H2 are more prominent)

Commands

The plugin adds several commands you can assign hotkeys to:

  • Cycle heading level - Cycles through H1 → H2 → H3 → H4 → H5 → H6 → Paragraph
  • Decrease heading level - H3 → H2 → H1
  • Increase heading level - H1 → H2 → H3
  • Set as Heading 1-6 - Directly set specific heading levels
  • Set as Paragraph - Convert heading to normal text

Settings

  • Show gutter badges - Toggle the visual markers on/off
  • Hierarchy checking - Get warnings when heading structure might be confusing
  • Allow hierarchy override - Choose whether to block or just warn about structure issues

Installation

From Community Plugins (Recommended)

  1. Open Obsidian Settings
  2. Go to Community Plugins and turn off Safe Mode
  3. Click Browse and search for "Heading Helper"
  4. Install and enable the plugin

Manual Installation

  1. Download the latest release files (main.js, manifest.json, styles.css)
  2. Create a folder named heading-helper in your vault's .obsidian/plugins/ directory
  3. Place the downloaded files in that folder
  4. Enable the plugin in Obsidian Settings → Community Plugins

Support

If you find this plugin helpful, you can:

  • ⭐ Star the repository
  • 🐛 Report issues on GitHub
  • 💡 Suggest new features

License

MIT License - see LICENSE file for details.


Roadmap

  • Integrate with Automatic Table of Contents to show the heading level in the toc
  • Customizable color for each heading level
  • Squash all actions into one action to better integrate with undo/redo
  • Allow for vim keybinds
72%
HealthGood
ReviewSatisfactory
About
Display visual heading indicators in the editor gutter and click markers to change heading levels. Cycle, increase, decrease, or set headings with commands and receive optional hierarchy warnings to spot structural issues.
EditingFormattingCommands
Details
Current version
1.0.3
Last updated
11 months ago
Created
12 months ago
Updates
4 releases
Downloads
835
Compatible with
Obsidian 1.6.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
sidkhuntiasidkhuntia
github.com/sidkhuntia
GitHubsidkhuntia
  1. Community
  2. Plugins
  3. Editing
  4. Heading Helper

Related plugins

Easy Typing

Auto format when typing.

Paste URL into selection

Paste URL "into" selected text.

Vimrc Support

Auto-load a startup file with Vim commands.

List Callouts

Create simple callouts in lists.

Code Editor Shortcuts

Add keyboard shortcuts (hotkeys) commonly found in code editors such as Visual Studio Code (VS Code) or Sublime Text.

Slash Commander

Customize the slash command list, assign each command an icon.

Symbols Prettifier

Prettify the symbols with actual symbols you commonly type, like arrows.

Smart Typography

Convert quotes to curly quotes, dashes to em dashes, and periods to ellipses.

Advanced Tables

Improved table navigation, formatting, and manipulation.

Quick Switcher++

Enhanced Quick Switcher, search open panels, and symbols.