Code · Made a little simpler

Markdown Heading Structure Auditor

Read actual ATX and Setext headings by source line. Find skipped levels, empty titles and repeated headings while keeping code samples out of the outline.

Free to useNo account neededProcessed on your device
Your workspaceProcessed on your device

Add this tool to your website

Paste this code into your page to add the tool and a visible ToolMellow credit link.

HTML embed code
Preview embed

Markdown Heading Structure Auditor: how to use it

  1. Paste or open a Markdown document and choose its dialect. Load the example to try a release guide with five top-level headings.
  2. Select Audit headings. Check the source line for each skipped level or empty or repeated title. Include headings in quotes and lists when those sections belong in the review.
  3. Fix the source in your editor and rerun the audit. Copy or download a text report for review.

Limits and notes

Reads up to 200,000 UTF-16 code units and 12,000 lines. Accepts pasted text and local Unicode files. Checks the Markdown outline under CommonMark or GitHub Flavored Markdown. Preview shows up to 100 headings and 100 findings. Report includes up to 1,000 of each.

How your privacy works →

Markdown Heading Structure Auditor: common questions

Are Markdown examples inside code fences counted?

No. A hash sign in a fenced or indented code block is code text. The auditor follows the selected parser’s heading rules.

What counts as a repeated heading?

The check compares displayed heading titles after collapsing whitespace, normalizing equivalent Unicode sequences and ignoring case. It does not predict a particular site’s generated anchors.

Is a missing H1 always a problem?

A standalone document often needs a title, while a fragment may receive an H1 from its template. Review the reported first heading alongside its publishing context.

Guides