mirror of
https://github.com/DavidAnson/markdownlint.git
synced 2025-12-21 08:20:12 +01:00
19 lines
853 B
Markdown
19 lines
853 B
Markdown
This rule is triggered when a link has generic text like `[click here](...)` or
|
|
`[link](...)`.
|
|
|
|
Link text should be descriptive and communicate the purpose of the link (e.g.,
|
|
`[Download the budget document](...)` or `[CommonMark Specification](...)`).
|
|
This is especially important for screen readers which sometimes present links
|
|
without context.
|
|
|
|
By default, this rule prohibits a small number of common English words/phrases.
|
|
To customize that list of words/phrases, set the `prohibited_texts` parameter to
|
|
an `Array` of `string`s.
|
|
|
|
Note: For languages other than English, use the `prohibited_texts` parameter to
|
|
customize the list for that language. It is *not* a goal for this rule to have
|
|
translations for every language.
|
|
|
|
Note: This rule checks Markdown links; HTML links are ignored.
|
|
|
|
More information: <https://webaim.org/techniques/hypertext/>
|