[GH-ISSUE #1424] MD051 - Support alternate heading link algorithms #683

New issue

Closed

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

kerem commented

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

Owner

Originally created by @otteydw on GitHub (Nov 18, 2024).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1424

My team primarily uses Bitbucket which has an alternate algorithm for linking to headings. In the case of Bitbucket, they want the linked headings to begin with #markdown-header- such that a link to the header "My Header" would need to be [my header](#markdown-header-my-header).

I don't know if there are other algorithms around (and I truly wish that Bitbucket did not use this uncommon algorithm), I was wondering if an option could be added to rule MD051 that supported Bitbucket's algorithm specifically? Or maybe an option to allow us to specify a header prefix that we should require for the link fragment to be valid?

Originally created by @otteydw on GitHub (Nov 18, 2024). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1424 My team primarily uses Bitbucket which has an alternate algorithm for linking to headings. In the case of Bitbucket, they want the linked headings to begin with `#markdown-header-` such that a link to the header "My Header" would need to be `[my header](#markdown-header-my-header)`. I don't know if there are other algorithms around (and I truly wish that Bitbucket did not use this uncommon algorithm), I was wondering if an option could be added to rule MD051 that supported Bitbucket's algorithm specifically? Or maybe an option to allow us to specify a header prefix that we should require for the link fragment to be valid?

kerem

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

closed this issue
added the
question
label

kerem commented

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

Author

Owner

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

Duplicate of https://github.com/DavidAnson/markdownlint/issues/547#issuecomment-1361218474

I'll revisit this soon.

@DavidAnson commented on GitHub (Nov 18, 2024): Duplicate of https://github.com/DavidAnson/markdownlint/issues/547#issuecomment-1361218474 I'll revisit this soon.

kerem commented

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

Author

Owner

@otteydw commented on GitHub (Nov 18, 2024):

Ugh, I swear I did search for it. I'm not sure how I missed that. Thank you.

@otteydw commented on GitHub (Nov 18, 2024): Ugh, I swear I did search for it. I'm not sure how I missed that. Thank you.

kerem commented

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

Author

Owner

@otteydw commented on GitHub (Nov 18, 2024):

Sorry, I'm actually not sure if I should have closed this or not. Please re-open if you need that for tracking.

@otteydw commented on GitHub (Nov 18, 2024): Sorry, I'm actually not sure if I should have closed this or not. Please re-open if you need that for tracking.

kerem commented

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

Author

Owner

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

It's cool. :) I have a private TODO list I use for tracking.

@DavidAnson commented on GitHub (Nov 18, 2024): It's cool. :) I have a private TODO list I use for tracking.

kerem referenced this issue

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

[GH-ISSUE #683] lists in quotes should not be linted as normal lists? #2355