Z510: HEADING_HIERARCHY

Severity: warning Penalty: 1.0 point Category: content Auto-fixable: No

Description

A heading level skips one or more levels in the document structure (for example, an H3 heading immediately follows an H1 heading without an intervening H2).

Skipping heading levels impairs screen reader navigation, breaks document outline generation, and compromises structural accessibility.

How to Fix

Adjust the heading level to maintain sequential hierarchy:

1. Ensure H2 follows H1.
2. Ensure H3 follows H2.

Suppression

If a skipped heading level is intentional, you can suppress this warning using an inline comment directive at or above the heading:

<!-- zenzic:ignore:Z510 -->

Reference

See the Finding Codes Index for finding code details.