Heading levels should increase by one; skipping levels (e.g

navigable/heading-order · Best practice

Heading levels should increase by one; skipping levels (e.g. h2 to h4) makes navigation harder.

Screen reader users navigate by headings to understand page structure. Skipping levels (h2 to h4) suggests missing content and creates confusion. Start with h1 for the page title, then use h2 for main sections, h3 for subsections, etc. You can go back up (h3 to h2) when starting a new section.

Scan a page or repo for issues like this · All rules

Introduced in @accesslint/core v0.8.0