[GH-ISSUE #1623] MD059 False positive when descriptive title is provided separately to non-descriptive link text #722

New issue

Closed

opened 2026-03-03 01:29:21 +03:00 by kerem · 1 comment

kerem commented

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

Owner

Originally created by @hwoodiwiss on GitHub (Jun 2, 2025).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1623

With the addition of MD059, I'm seeing errors on a link that does use one of the prohibited texts, however, the link also has separately provided alt-text that gets rendered as the Title attribute of the <a> tag.

The example in question is:

[here](https://raw.githubusercontent.com/justeattakeaway/httpclient-interception/main/src/HttpClientInterception/Bundles/http-request-bundle-schema.json "JSON Schema for HTTP request interception bundles for use with JustEat.HttpClientInterception.").

Which renders to here.

I think in this case, MD059 wouldn't apply as I believe screen readers should read the link title.

Originally created by @hwoodiwiss on GitHub (Jun 2, 2025). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/1623 With the addition of MD059, I'm seeing errors on a link that does use one of the prohibited texts, however, the link also has separately provided alt-text that gets rendered as the Title attribute of the `<a>` tag. The example in question is: ```md [here](https://raw.githubusercontent.com/justeattakeaway/httpclient-interception/main/src/HttpClientInterception/Bundles/http-request-bundle-schema.json "JSON Schema for HTTP request interception bundles for use with JustEat.HttpClientInterception."). ``` Which renders to [here](https://raw.githubusercontent.com/justeattakeaway/httpclient-interception/main/src/HttpClientInterception/Bundles/http-request-bundle-schema.json "JSON Schema for HTTP request interception bundles for use with JustEat.HttpClientInterception."). I think in this case, MD059 wouldn't apply as I believe screen readers should read the link title.

kerem closed this issue

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

kerem commented

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

Author

Owner

@nschonni commented on GitHub (Jun 2, 2025):

No, here is a random article that explains the difference https://www.accessibilitychecker.org/guides/alt-text/

@nschonni commented on GitHub (Jun 2, 2025): No, here is a random article that explains the difference https://www.accessibilitychecker.org/guides/alt-text/

kerem referenced this issue

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

[PR #722] [MERGED] Improved YAML Schema build (#721) #974

kerem referenced this issue

2026-03-07 20:10:45 +03:00

[PR #722] [MERGED] Improved YAML Schema build (#721) #2825