template-heading-structure-invalid

Reports an invalid H1 count or skipped heading level in a completed typed document.

← All Rules

What it does

Reports a completed typed document whose first heading is not an H1, that contains more than one H1, or that increases heading depth by more than one level.

Why it matters

The document needs a coherent heading tree before its Template-specific headings can form a reliable structure.

Examples

Non-passing

# First

# Second

Passing

# Choice

## Context

### Constraints

When it applies

This Rule belongs to the configurable document-types group. It checks recognized documents that match a loaded Document Type, whether the Template is strict or non-strict.

References

See Presswork Configuration for Document Types and src/template.ts for heading-structure evaluation.