How to number headings in Markdown
Add automatic section numbering (1, 1.1, 1.2) to your Markdown headings — the standard for specs, manuals, and academic documents that need cross-references.
Specifications, manuals, contracts, and academic papers number their sections so people can reference "see §2.3." Markdown has no built-in numbering, so the Markdown Heading Numberer adds it for you.
What it does
It walks your headings and prepends a hierarchical number to each, based on its level:
# 1. Overview
## 1.1 Scope
## 1.2 Definitions
# 2. Requirements
## 2.1 Functional
The numbering nests with the heading levels and increments correctly, so adding or removing a section and re-running it renumbers everything consistently.
When you need numbered headings
- Specifications and RFCs — so reviewers can cite a precise section.
- Manuals and SOPs — "complete step 3.2 before 3.3."
- Academic and legal documents — where numbered sections are the convention.
- Long internal docs — numbering doubles as a quick sense of depth and progress.
Pairing with a table of contents
Numbered headings and a table of contents work well together: number first, then generate the TOC so the contents entries carry the section numbers too. Readers get both a numbered reference scheme and clickable navigation.
Removing numbers
Changed your mind, or the destination adds its own numbering? Re-running tools in the structure set lets you renumber or restructure; if you need to start clean, remove the prefixes and regenerate.
Privacy
The conversion is local; your document never leaves the browser — appropriate for unpublished specs and internal manuals.
Add the numbers, cite with confidence, renumber whenever the structure changes.