[GH-ISSUE #1416] first-line-h1 insufficient replacement for first-heading-h1 #681

New issue

Closed

opened 2026-03-03 01:29:00 +03:00 by kerem · 2 comments

kerem commented

2026-03-03 01:29:00 +03:00

Owner

Originally created by @bbodenmiller on GitHub (Nov 14, 2024).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1416

There is times that the first line is not desired as a header (e.g. a TOC) but that we want to ensure the first header (which follows TOC) is in fact H1. This does not appear possible with first-line-h1

Originally created by @bbodenmiller on GitHub (Nov 14, 2024). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1416 There is times that the first line is not desired as a header (e.g. a TOC) but that we want to ensure the first header (which follows TOC) is in fact H1. This does not appear possible with `first-line-h1`

kerem

2026-03-03 01:29:00 +03:00

closed this issue
added the
enhancement

fixed in next
labels

kerem commented

2026-03-03 01:29:02 +03:00

Author

Owner

@DavidAnson commented on GitHub (Nov 14, 2024):

Agreed. I'm not sure the behavior you describe is entirely in keeping with the intent of MD041/first-line-heading, anyway.

However, it could be a reasonable thing for MD001/heading-increment to enforce, assuming it got a new parameter starting_level which would be set to 1 in your case.

https://github.com/DavidAnson/markdownlint/blob/main/doc/md001.md

@DavidAnson commented on GitHub (Nov 14, 2024): Agreed. I'm not sure the behavior you describe is entirely in keeping with the intent of MD041/first-line-heading, anyway. However, it could be a reasonable thing for MD001/heading-increment to enforce, assuming it got a new parameter starting_level which would be set to 1 in your case. https://github.com/DavidAnson/markdownlint/blob/main/doc/md001.md

kerem commented

2026-03-03 01:29:02 +03:00

Author

Owner

@bbodenmiller commented on GitHub (Nov 14, 2024):

@DavidAnson starting_level option on MD001/heading-increment would certainly work!

@bbodenmiller commented on GitHub (Nov 14, 2024): @DavidAnson starting_level option on MD001/heading-increment would certainly work!

kerem referenced this issue

2026-03-07 20:06:57 +03:00

[GH-ISSUE #681] [Proposal] Rule to discourage generic link text #2352