Skip to main content


Warns for skipped heading levels.

Each heading following another heading lead in the outline must have a heading level that is less than, equal to, or 1 greater than lead's heading level.

Cite: HTML Living Standard 4.3.11 Headings and outlines

❌ Examples of incorrect code for this rule

<h1>Heading 1</h1>
<h3>Heading 3<!-- SKIPPED --></h3>
<h4>Heading 3</h4>

✅ Examples of correct code for this rule

<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>


"heading-levels": boolean

Warns for skipped heading levels

Default Severity