Heading Structure Auditor

Detect skipped levels, duplicate H1s, and broken heading hierarchy in HTML/Markdown.

About Heading Structure Auditor

Paste HTML or Markdown and instantly audit your heading hierarchy. Detects skipped heading levels (H1→H3), multiple H1 tags, empty headings, and improper nesting. Perfect for WCAG 1.3.1 compliance.

How to Use

  1. 1Paste your HTML or Markdown into the input area.
  2. 2The tool extracts all headings and builds a visual tree.
  3. 3Issues (skipped levels, multiple H1, empty headings) are highlighted in red.
  4. 4Click any issue to see an explanation and suggested fix.
  5. 5Copy the corrected heading structure.

Frequently Asked Questions

Why does heading structure matter for accessibility?
Screen reader users navigate pages using headings as landmarks. Skipped levels (e.g. H1 to H3) or multiple H1s confuse this navigation, breaking WCAG 1.3.1 (Info and Relationships).
How many H1 tags should a page have?
Typically one — the page's main title. Multiple H1s are allowed in HTML5 sectioning elements but most screen readers still treat the first H1 as the top-level heading.
Does this work with Markdown?
Yes — paste Markdown with # ## ### syntax. The tool converts it to a heading tree and applies the same checks.
What is a skipped heading level?
Going from H2 directly to H4 without an H3 between them. This breaks the logical hierarchy that assistive technologies rely on.