Hidden Problems Lab

Section Numbering as an alternative to Number Headings

Looking for an alternative to Number Headings? Here are the public facts for both plugins and the steps to switch without losing your work.

At a glance

Section Numbering as an alternative to Number Headings
DetailNumber HeadingsSection Numbering
What it doesAutomatically number or re-number headings.Numbers your headings as an outline (1, 1.1, 1.2) and renumbers them when sections move. Links to a renumbered heading, in the note and across the vault, are rewritten so they keep working.
Authoronlyaflysiulved54
Latest version in the directory1.16.00.10.1
Last update recorded3 October 20232 November 2026
Total downloads101,1893,385
PriceFree and open source

What Section Numbering does

Outline numbers for your headings — 1., 1.1., 1.2. — that stay right when you move sections around, without breaking the links that point at them. Show the numbers on screen and leave your notes untouched, or write them into the text; add a table of contents that keeps itself up to date.

How to switch from Number Headings to Section Numbering

  1. Install Section Numbering from Install from the Obsidian directory.
  2. In Settings, Community plugins, turn Number Headings off without deleting it, so the two do not act on the same action at once.
  3. Open the Section Numbering settings and review them once: settings from Number Headings are not copied over.
  4. When everything works the way you expect, uninstall Number Headings.

More about

Where these facts come from

Name, author, description, version, last-update date and downloads come from the public Obsidian directory files (community-plugins.json and community-plugin-stats.json), read on 12 November 2026. Download counts are the ones Obsidian publishes.

This page is written by the person who makes Section Numbering. If you maintain Number Headings and want something corrected or removed, open an issue in the repository and it will be handled.