Auto Numbered Headings

Automatically numbers headings in your Markdown notes as you type.

Description

The Auto Numbered Headings plugin provides transparent, real-time heading renumbering. It ensures your document structure remains consistent by automatically updating heading numbers as you move, add, or delete sections. Because it modifies the actual document text, the numbering is preserved across all Markdown editors and exports.

Usage

Opt-in pattern

Add a number and a dot to any heading to start auto-numbering:

• # 1. Introduction activates numbering for level 1 headings.
• ## 1.1. Background activates numbering for level 2 headings.

Hierarchical numbering

The plugin supports multi-segment hierarchical numbering:

• # 1. First Section
• ## 1.1. Subsection
• ### 1.1.1. Deep Section

Numbering behavior

Renumbering is triggered when a heading's number ends with a dot and a space (for example ### 2.3. Title). Typing that dot re-runs numbering across every numbered heading in the note.

• Numbers are written without a trailing dot after renumbering (for example ### 2.3 Title). Both forms are recognized, so a heading that has already been renumbered is still managed.
• Optionally, the shallowest heading level in the note can keep a trailing dot (for example # 1. Title). Enable this via Trailing dot on first level in the plugin settings.
• Numbering is hierarchical and relative to the shallowest heading level in the note. If a level is skipped, the missing level is filled with a zero (for example an #### directly under an ## becomes 2.0.1).
• Unnumbered headings such as ### Notes are left untouched and do not affect the count.

Settings

Access settings via Settings → Community plugins → Auto Numbered Headings.

• Enable auto-numbering: Toggle the entire plugin on or off.
• Trailing dot on first level: When on, the shallowest heading level in the note keeps a trailing dot (for example # 1. Title). When off (default), numbers are written without a trailing dot at any level.