[GH-ISSUE #1390] MD001 fails to detect <hN> tag #2521

New issue

Closed

opened 2026-03-07 20:08:33 +03:00 by kerem · 1 comment

kerem commented

2026-03-07 20:08:33 +03:00

Owner

Originally created by @xuhdev on GitHub (Oct 23, 2024).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1390

markdownlint-cli2 reports error for the following markdown file:

# H1

<h2>H2</h2>

### H3

a.md:5 MD001/heading-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]

Originally created by @xuhdev on GitHub (Oct 23, 2024). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1390 markdownlint-cli2 reports error for the following markdown file: ```md # H1 <h2>H2</h2> ### H3 ``` ``` a.md:5 MD001/heading-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3] ```

kerem

2026-03-07 20:08:33 +03:00

closed this issue
added the
question
label

kerem commented

2026-03-07 20:08:34 +03:00

Author

Owner

@DavidAnson commented on GitHub (Oct 23, 2024):

This rule (along with almost all the rules) does not attempt to reconcile Markdown structure with embedded HTML elements. (In fact, using HTML is discouraged per rule MD033.) There are many ways a document could alternate between Markdown and HTML and it is not a goal of this tool to try to make sense of all that.

@DavidAnson commented on GitHub (Oct 23, 2024): This rule (along with almost all the rules) does not attempt to reconcile Markdown structure with embedded HTML elements. (In fact, using HTML is discouraged per rule MD033.) There are many ways a document could alternate between Markdown and HTML and it is not a goal of this tool to try to make sense of all that.