[GH-ISSUE #676] Showing a warning about url encoded special characters when linking to headings #502

New issue

Closed

opened 2026-03-03 01:27:30 +03:00 by kerem · 1 comment

kerem commented

2026-03-03 01:27:30 +03:00

Owner

Originally created by @Breigner01 on GitHub (Dec 12, 2022).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/676

So basically I have something like this in a markdown:

- [Build & Run](#build-%26-run)

# Build & Run

Which looks something like this:

Build & Run

Build & Run

I first realized that I couldn't use the ampersand character in the link but encoding it for URL works.
The slight "issue" if we can say so, is that markdownlint shows a warning because it thinks the link is not right but the markdown preview plugin that I'm using rightfully redirects to the right heading.

It would be nice to see this plugin interpret URL-encoded characters.

Originally created by @Breigner01 on GitHub (Dec 12, 2022). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/676 So basically I have something like this in a markdown: ``` - [Build & Run](#build-%26-run) # Build & Run ``` Which looks something like this: - [Build & Run](#build-%26-run) # Build & Run I first realized that I couldn't use the ampersand character in the link but encoding it for URL works. The slight "issue" if we can say so, is that markdownlint shows a warning because it thinks the link is not right but the markdown preview plugin that I'm using rightfully redirects to the right heading. It would be nice to see this plugin interpret URL-encoded characters.

kerem

2026-03-03 01:27:30 +03:00

closed this issue
added the
question
label

kerem commented

2026-03-03 01:27:31 +03:00

Author

Owner

@DavidAnson commented on GitHub (Dec 12, 2022):

MD051 enforces the GitHub algorithm as described here: https://github.com/DavidAnson/markdownlint/blob/next/doc/md051.md

That algorithm removes punctuation which leads to:

# Build & Run

- [Build & Run](#build--run)

Which produces no errors when linted: https://dlaa.me/markdownlint/#%25m%23%20Build%20%26%20Run%0A%0A-%20%5BBuild%20%26%20Run%5D(%23build--run)%0A

@DavidAnson commented on GitHub (Dec 12, 2022): MD051 enforces the GitHub algorithm as described here: <https://github.com/DavidAnson/markdownlint/blob/next/doc/md051.md> That algorithm removes punctuation which leads to: ```markdown # Build & Run - [Build & Run](#build--run) ``` Which produces no errors when linted: <https://dlaa.me/markdownlint/#%25m%23%20Build%20%26%20Run%0A%0A-%20%5BBuild%20%26%20Run%5D(%23build--run)%0A>

kerem referenced this issue

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

[GH-ISSUE #502] New rule: No line wrapping #2258