This commit is contained in:
valeriapenaespitia-alt 2025-11-26 21:24:59 -06:00 committed by GitHub
parent 224987d727
commit 970d09e715
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 2 additions and 0 deletions

View file

@ -0,0 +1 @@
html

View file

@ -0,0 +1,38 @@
# `MD001` - Heading levels should only increment by one level at a time
Tags: `headings`
Aliases: `heading-increment`
This rule is triggered when you skip heading levels in a Markdown document, for
example:
```markdown
# Heading 1
### Heading 3
We skipped out a 2nd level heading in this document
```
When using multiple heading levels, nested headings should increase by only one
level at a time:
```markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
## Another Heading 2
### Another Heading 3
```
Rationale: Headings represent the structure of a document and can be confusing
when skipped - especially for accessibility scenarios. More information:
<https://www.w3.org/WAI/tutorials/page-structure/headings/>.