mirror of
https://github.com/DavidAnson/markdownlint.git
synced 2025-09-22 05:40:48 +02:00
32 lines
617 B
Markdown
32 lines
617 B
Markdown
|
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/>.
|