Heading Hierarchy
Validates heading structure and 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
squirrel.toml
toml[rules]
disable = ["content/heading-hierarchy"]Disable all Content rules
squirrel.toml
toml[rules]
disable = ["content/*"]Enable only this rule
squirrel.toml
toml[rules]
enable = ["content/heading-hierarchy"]
disable = ["*"]