Heading Hierarchy

Validates heading structure and hierarchy

Rule ID	content/heading-hierarchy
Category	Content
Scope	Per-page
Severity	warning
Weight	5/10

Solution

Proper heading structure (H1 → H2 → H3) helps users and search engines understand your content organization. Skipping levels (H1 → H3) creates confusion. Use headings in sequential order without skipping levels. Each section should use the next heading level down. Think of headings as an outline: they should make sense when read alone. Avoid empty headings or using headings purely for styling.

Enable / Disable

Disable this rule

[rules]
disable = ["content/heading-hierarchy"]

Disable all Content rules

[rules]
disable = ["content/*"]

Enable only this rule

[rules]
enable = ["content/heading-hierarchy"]
disable = ["*"]