Markdown Heading Level Shifter
Shift Markdown heading levels up or down across entire documents. Demote headings (H1 → H2) when embedding chapters into larger wikis, or promote headings (H2 → H1).
Promote & Demote Markdown Heading Levels Online (H1-H6)
Shift heading levels (+1 or -1) across entire Markdown documents. Easily nest standalone articles under existing guide headers or promote sub-sections into top-level pages.
How to Use the Markdown Heading Shifter
Paste Document
Input your Markdown file with various heading depths (H1-H6).
Select Shift Level
Choose +1 to demote (e.g. embed inside a chapter) or -1 to promote section levels.
Copy Result
Click 'Copy Markdown' to paste your restructured document into your documentation repository.
Key Features & Capabilities
Pro Tips & Best Practices
- •Demote all headings by +1 when importing external README files into multi-page Docusaurus or Next.js documentation sites.
Frequently Asked Questions
Why do I need to shift heading levels?
When merging multiple standalone Markdown files into a single book or documentation site, having multiple H1 headings ruins SEO hierarchy. Shifting allows you to demote an entire file to H2 and below instantly.
What happens to H6 headings when shifting down (+1)?
Markdown headings are clamped at level 6 (######). Any heading already at H6 remains at H6.
Will code comments with # be modified?
No! Code fences (```) are detected and protected from heading adjustments.
Related Markdown Tools
Heading Numberer
Hierarchically auto-number heading sections (1., 1.1, 1.1.1) while preserving code blocks.
TOC Generator
Generate clickable Table of Contents lists with GitHub-compatible heading anchor slugs.
Formatter & Beautifier
Automated syntax beautifier, list re-indexer, table aligner, and whitespace normalizer.
Diff & Compare
Side-by-side and unified text diff comparator highlighting word-level revisions.