Add rule MD059/descriptive-link-text "Link text should be descriptive" (fixes #681).

2025-09-21 21:30:47 +02:00 · 2025-01-06 11:35:17 -05:00 · 2025-01-06 11:35:17 -05:00 · b8374ec5d2
commit b8374ec5d2
parent 4117394250
40 changed files with 1159 additions and 234 deletions
--- a/README.md
+++ b/README.md
@ -146,6 +146,7 @@ playground for learning and exploring.
 - **[MD055](doc/md055.md)** *table-pipe-style* - Table pipe style
 - **[MD056](doc/md056.md)** *table-column-count* - Table column count
 - **[MD058](doc/md058.md)** *blanks-around-tables* - Tables should be surrounded by blank lines
+- **[MD059](doc/md059.md)** *descriptive-link-text* - Link text should be descriptive

 <!-- markdownlint-restore -->

@ -165,7 +166,7 @@ To implement your own rules, refer to [CustomRules.md](doc/CustomRules.md).
 Tags group related rules and can be used to enable/disable multiple
 rules at once.

- **`accessibility`** - `MD045`
+- **`accessibility`** - `MD045`, `MD059`
 - **`atx`** - `MD018`, `MD019`
 - **`atx_closed`** - `MD020`, `MD021`
 - **`blank_lines`** - `MD012`, `MD022`, `MD031`, `MD032`, `MD047`
@ -183,7 +184,7 @@ rules at once.
 - **`language`** - `MD040`
 - **`line_length`** - `MD013`
 - **`links`** - `MD011`, `MD034`, `MD039`, `MD042`, `MD051`, `MD052`, `MD053`,
-  `MD054`
+  `MD054`, `MD059`
 - **`ol`** - `MD029`, `MD030`, `MD032`
 - **`spaces`** - `MD018`, `MD019`, `MD020`, `MD021`, `MD023`
 - **`spelling`** - `MD044`
--- a/doc-build/md059.md
+++ b/doc-build/md059.md
@ -0,0 +1,16 @@
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.
--- a/doc/Rules.md
+++ b/doc/Rules.md
@ -2538,6 +2538,35 @@ Some text
 Rationale: In addition to aesthetic reasons, some parsers will incorrectly parse
 tables that don't have blank lines before and after them.

+<a name="md059"></a>
+
+## `MD059` - Link text should be descriptive
+
+Tags: `accessibility`, `links`
+
+Aliases: `descriptive-link-text`
+
+Parameters:
+
+- `link_texts`: List of restricted link texts (`string[]`, default `[]`)
+
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.
+
 <!-- markdownlint-configure-file {
  "no-inline-html": {
    "allowed_elements": [
--- a/doc/md059.md
+++ b/doc/md059.md
@ -0,0 +1,26 @@
+# `MD059` - Link text should be descriptive
+
+Tags: `accessibility`, `links`
+
+Aliases: `descriptive-link-text`
+
+Parameters:
+
+- `link_texts`: List of restricted link texts (`string[]`, default `[]`)
+
+This rule is triggered when a link is set with generic text like
+"Click here", "here", or "learn more", giving it a generic accessible name.
+
+Rationale: Screen reader users may navigate through a list of links
+to quickly find content on a page. When the link name is something ambiguous
+like "Learn more", there isn't sufficient context to help the user determine
+whether to follow the link.
+
+Link names should be descriptive and describe the purpose of the link, like:
+`[Download the budget document]`, `[About markdownlint]`,`[View registration]`,
+etc.
+
+To override the default list and configure your own list of banned accessible
+names, set `link_texts` in the config.
+
+Note: This rule checks Markdown-style links and ignores HTML-style links.
--- a/lib/configuration-strict.d.ts
+++ b/lib/configuration-strict.d.ts
@ -1100,6 +1100,28 @@ export interface ConfigurationStrict {
   * MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
   */
  "blanks-around-tables"?: boolean;
+  /**
+   * MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+   */
+  MD059?:
+    | boolean
+    | {
+        /**
+         * List of restricted link texts
+         */
+        link_texts?: string[];
+      };
+  /**
+   * MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+   */
+  "descriptive-link-text"?:
+    | boolean
+    | {
+        /**
+         * List of restricted link texts
+         */
+        link_texts?: string[];
+      };
  /**
   * headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043
   */
@ -1125,7 +1147,7 @@ export interface ConfigurationStrict {
   */
  hard_tab?: boolean;
  /**
-   * links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054
+   * links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059
   */
  links?: boolean;
  /**
@ -1185,7 +1207,7 @@ export interface ConfigurationStrict {
   */
  spelling?: boolean;
  /**
-   * accessibility : MD045
+   * accessibility : MD045, MD059
   */
  accessibility?: boolean;
  /**
--- a/lib/md059.mjs
+++ b/lib/md059.mjs
@ -0,0 +1,60 @@
+// @ts-check
+
+import { addErrorContext } from "../helpers/helpers.cjs";
+import { filterByTypesCached } from "./cache.mjs";
+
+const defaultBannedText = [
+  "click here",
+  "here",
+  "learn more",
+  "link",
+  "more",
+  "read more"
+];
+
+/**
+ * Normalizes a string and removes extra whitespaces and punctuations.
+ *
+ * @param {string} text String to transform.
+ * @returns {string} Normalized string with no punctuations or extra whitespaces.
+ */
+function normalizeText(text) {
+  return text
+    .toLowerCase()
+    .replace(/\W+/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+/** @type {import("markdownlint").Rule} */
+export default {
+  "names": [ "MD059", "descriptive-link-text" ],
+  "description": "Link text should be descriptive",
+  "tags": [ "links", "accessibility" ],
+  "parser": "micromark",
+  "function": function MD059(params, onError) {
+    const bannedNames = new Set(params.config.link_texts || defaultBannedText);
+    const labels = filterByTypesCached([ "label" ])
+      .filter((label) => label.parent?.type === "link");
+
+    for (const label of labels) {
+      const labelTexts = label.children.filter((child) => child.type === "labelText");
+      for (const labelText of labelTexts) {
+        const { text } = label;
+        if (bannedNames.has(normalizeText(text))) {
+          const range = labelText.startLine === labelText.endLine ?
+            [ labelText.startColumn, text.length ] :
+            undefined;
+          addErrorContext(
+            onError,
+            labelText.startLine,
+            text,
+            undefined,
+            undefined,
+            range
+          );
+        }
+      }
+    }
+  }
+};
--- a/lib/rules.mjs
+++ b/lib/rules.mjs
@ -53,6 +53,7 @@ import md054 from "./md054.mjs";
 import md055 from "./md055.mjs";
 import md056 from "./md056.mjs";
 import md058 from "./md058.mjs";
+import md059 from "./md059.mjs";

 const rules = [
  md001,
@ -108,7 +109,8 @@ const rules = [
  md055,
  md056,
  // md057: See https://github.com/markdownlint/markdownlint
-  md058
+  md058,
+  md059
 ];
 for (const rule of rules) {
  const name = rule.names[0].toLowerCase();
--- a/schema/.markdownlint.jsonc
+++ b/schema/.markdownlint.jsonc
@ -306,5 +306,11 @@
  "MD056": true,

  // MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
-  "MD058": true
+  "MD058": true,
+
+  // MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+  "MD059": {
+    // List of restricted link texts
+    "link_texts": []
+  }
 }
--- a/schema/.markdownlint.yaml
+++ b/schema/.markdownlint.yaml
@ -275,3 +275,8 @@ MD056: true

 # MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md058.md
 MD058: true
+
+# MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md
+MD059:
+  # List of restricted link texts
+  link_texts: []
--- a/schema/build-config-schema.mjs
+++ b/schema/build-config-schema.mjs
@ -556,6 +556,18 @@ for (const rule of rules) {
        }
      };
      break;
+    case "MD059":
+      scheme.properties = {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      };
+      break;
    default:
      custom = false;
      break;
--- a/schema/markdownlint-config-schema-strict.json
+++ b/schema/markdownlint-config-schema-strict.json
@ -1716,6 +1716,44 @@
      "type": "boolean",
      "default": true
    },
+    "MD059": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
+    "descriptive-link-text": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
    "headings": {
      "description": "headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043",
      "type": "boolean",
@ -1747,7 +1785,7 @@
      "default": true
    },
    "links": {
-      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054",
+      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059",
      "type": "boolean",
      "default": true
    },
@ -1822,7 +1860,7 @@
      "default": true
    },
    "accessibility": {
-      "description": "accessibility : MD045",
+      "description": "accessibility : MD045, MD059",
      "type": "boolean",
      "default": true
    },
--- a/schema/markdownlint-config-schema.json
+++ b/schema/markdownlint-config-schema.json
@ -1716,6 +1716,44 @@
      "type": "boolean",
      "default": true
    },
+    "MD059": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
+    "descriptive-link-text": {
+      "description": "MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md059.md",
+      "type": [
+        "boolean",
+        "object"
+      ],
+      "default": true,
+      "properties": {
+        "link_texts": {
+          "description": "List of restricted link texts",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "additionalProperties": false
+    },
    "headings": {
      "description": "headings : MD001, MD003, MD018, MD019, MD020, MD021, MD022, MD023, MD024, MD025, MD026, MD036, MD041, MD043",
      "type": "boolean",
@ -1747,7 +1785,7 @@
      "default": true
    },
    "links": {
-      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054",
+      "description": "links : MD011, MD034, MD039, MD042, MD051, MD052, MD053, MD054, MD059",
      "type": "boolean",
      "default": true
    },
@ -1822,7 +1860,7 @@
      "default": true
    },
    "accessibility": {
-      "description": "accessibility : MD045",
+      "description": "accessibility : MD045, MD059",
      "type": "boolean",
      "default": true
    },
--- a/test/bare-urls.md
+++ b/test/bare-urls.md
@ -12,7 +12,7 @@ Visit https://example.com, then refresh. {MD034}

 The site (https://example.com) is down. {MD034}

-<!-- markdownlint-disable line-length no-inline-html -->
+<!-- markdownlint-disable descriptive-link-text line-length no-inline-html -->

 Some documents use <a href="https://example.com">to link</a>.

--- a/test/descriptive-link-text-empty-config.md
+++ b/test/descriptive-link-text-empty-config.md
@ -0,0 +1,35 @@
+# Descriptive link text empty config
+
+[Learn about Javascript](https://example.com/javascript/about)
+
+[About Javascript](https://example.com/file.txt)
+
+Learn about [our mission](https://example.com/mission).
+
+Go [here](https://example.com/descriptive-links)
+
+[Learn more](https://example.com/images/about) about us.
+
+[Click here](https://example.com/dir/file.txt).
+
+[read more](https://example.com/guide).
+
+To get more support, go [here!](https://example.com/contact).
+
+Learn [more.](https://example.com/contact).
+
+To learn about our company, [click here!!!!](https://example.com/about).
+
+[click-here!!!!](https://example.com/first).
+
+Go to this [link]((https://example.com/second)).
+
+[link][url]
+
+[url]: https://example.com
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": {
+    "link_texts": []
+  }
+} -->
--- a/test/descriptive-link-text-override.md
+++ b/test/descriptive-link-text-override.md
@ -0,0 +1,23 @@
+# Descriptive link text override
+
+[Go here](https://example.com/javascript/about) {MD059}
+
+[Learn more](https://example.com/javascript/about).
+
+[Click here](https://example.com/javascript/about).
+
+To learn more, go [here!](https://example.com/site).
+
+To learn more, go to this [link!](https://example.com/links).
+
+If you need additional guidance, read [this](https://example.com/links). {MD059}
+
+[link][url]
+
+[url]: https://example.com
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": {
+    "link_texts": ["go here", "this"]
+  }
+} -->
--- a/test/descriptive-link-text.md
+++ b/test/descriptive-link-text.md
@ -0,0 +1,32 @@
+# Descriptive link text
+
+[Learn about Javascript](https://example.com/javascript/about)
+
+[About Javascript](https://example.com/file.txt)
+
+Learn about [our mission](https://example.com/mission).
+
+Go [here](https://example.com/descriptive-links) {MD059}
+
+[Learn more](https://example.com/images/about) about us. {MD059}
+
+[Click here](https://example.com/dir/file.txt). {MD059}
+
+[read more](https://example.com/guide). {MD059}
+
+To get more support, go [here!](https://example.com/contact). {MD059}
+
+Learn [more](https://example.com/contact). {MD059}
+
+To learn more, [click here!!!!](https://example.com/about). {MD059}
+
+[click-here!!!!](https://example.com/first). {MD059}
+
+Go to this [link]((https://example.com/second)). {MD059}
+
+[link][Example URL] {MD059}
+
+[Example URL]: https://example.com
+
+{MD059} [click
+here](https://example.com)
--- a/test/fixing-with-front-matter.md
+++ b/test/fixing-with-front-matter.md
@ -5,7 +5,7 @@ ignore: this
 # Fixing with Front Matter {MD022}
 Text text text {MD009}   

-Text [ link ](url) text {MD039}
+Text [ link ](url) text {MD039} {MD059}
 ## Nested Heading {MD022}

 Text {MD047}
--- a/test/link-style-no-url-inline-not-possible.md
+++ b/test/link-style-no-url-inline-not-possible.md
@ -60,6 +60,7 @@ Text [email] text
 [email]: user@example.com

 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
  "link-image-style": {
    "autolink": false,
    "url_inline": false
--- a/test/link-style-no-url-inline-possible.md
+++ b/test/link-style-no-url-inline-possible.md
@ -61,6 +61,7 @@ Text [email] text
 [email]: user@example.com

 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
  "link-image-style": {
    "url_inline": false
  }
--- a/test/links-alternate.md
+++ b/test/links-alternate.md
@ -45,5 +45,6 @@ Text [ link ][reference] text. {MD039}

 <!-- markdownlint-configure-file {
  "line-length": false,
-  "code-block-style": false
+  "code-block-style": false,
+  "descriptive-link-text": false
 } -->
--- a/test/long-lines-long-reference-definitions-stern.md
+++ b/test/long-lines-long-reference-definitions-stern.md
@ -17,6 +17,7 @@
 [long-reference-definition]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long

 <!-- markdownlint-configure-file {
+  "descriptive-link-text": false,
  "line-length": {
    "stern": true
  }
--- a/test/long-lines-long-reference-definitions-strict.md
+++ b/test/long-lines-long-reference-definitions-strict.md
@ -19,5 +19,6 @@
 <!-- markdownlint-configure-file {
  "line-length": {
    "strict": true
-  }
+  },
+  "descriptive-link-text": false
 } -->
--- a/test/long-lines-long-reference-definitions.md
+++ b/test/long-lines-long-reference-definitions.md
@ -15,3 +15,5 @@
 [long-reference-definition-image]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long/image
 <!-- markdownlint-disable-next-line link-image-reference-definitions -->
 [long-reference-definition]: https://example.com/long/long/long/long/long/long/long/long/long/long/long/long/long
+
+<!-- markdownlint-disable-file descriptive-link-text -->
--- a/test/markdown-in-html.md
+++ b/test/markdown-in-html.md
@ -34,4 +34,4 @@ Text

 </p>

-<!-- markdownlint-disable-file line-length no-inline-html -->
+<!-- markdownlint-disable-file descriptive-link-text line-length no-inline-html -->
--- a/test/markdownlint-test.mjs
+++ b/test/markdownlint-test.mjs
@ -832,7 +832,7 @@ test("customFileSystemAsync", (t) => new Promise((resolve) => {
 }));

 test("readme", async(t) => {
-  t.plan(128);
+  t.plan(130);
  const tagToRules = {};
  for (const rule of rules) {
    for (const tag of rule.tags) {
@ -907,7 +907,7 @@ test("readme", async(t) => {
 });

 test("validateJsonUsingConfigSchemaStrict", async(t) => {
-  t.plan(182);
+  t.plan(187);
  // @ts-ignore
  const ajv = new Ajv(ajvOptions);
  const validateSchemaStrict = ajv.compile(configSchemaStrict);
@ -1029,7 +1029,7 @@ test("validateConfigExampleJson", (t) => {
 });

 test("allBuiltInRulesHaveValidUrl", (t) => {
-  t.plan(153);
+  t.plan(156);
  for (const rule of rules) {
    // @ts-ignore
    t.truthy(rule.information);
--- a/test/reversed_link.md
+++ b/test/reversed_link.md
@ -87,5 +87,6 @@ Text (text()[text] text
 <!-- markdownlint-configure-file {
  "code-block-style": false,
  "line-length": false,
-  "no-inline-html": false
+  "no-inline-html": false,
+  "descriptive-link-text": false
 } -->
--- a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md
+++ b/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.md
@ -16,4 +16,33 @@ Generated by [AVA](https://avajs.dev).
    test-repos/dotnet-docs/SECURITY.md: 25: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
    test-repos/dotnet-docs/SECURITY.md: 26: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
    test-repos/dotnet-docs/SECURITY.md: 27: MD007/ul-indent Unordered list indentation [Expected: 0; Actual: 2]␊
-    test-repos/dotnet-docs/SECURITY.md: 17: MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]`
+    test-repos/dotnet-docs/SECURITY.md: 17: MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]␊
+    test-repos/dotnet-docs/docs/architecture/blazor-for-web-forms-developers/security-authentication-authorization.md: 258: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/architecture/cloud-native/deploy-eshoponcontainers-azure.md: 60: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/diagnostics/built-in-metrics-aspnetcore.md: 12: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/testing/unit-testing-code-coverage.md: 274: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/core/testing/unit-testing-platform-architecture-extensions.md: 501: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/csharp/delegate-class.md: 41: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/csharp/whats-new/breaking-changes.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/framework/windows-workflow-foundation/samples/sql-tracking.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fsharp/language-reference/computation-expressions.md: 277: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/code-analysis/quality-rules/ca1066.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/code-analysis/quality-rules/ca1067.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/networking/http/httpclient-migrate-from-httpwebrequest.md: 340: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/fundamentals/networking/http/httpclient-migrate-from-httpwebrequest.md: 580: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/deployment/consul-deployment.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/index.md: 107: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-programming-apis.md: 14: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-programming-apis.md: 321: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/streaming/streams-why.md: 68: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/orleans/tutorials-and-samples/overview-helloworld.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/docs/standard/native-interop/tutorial-comwrappers.md: 251: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/authn-apis-json-types.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/authn-google-plus-authn-changes.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/core-changes/aspnetcore/3.0/kestrel-connection-adapters-removed.md: 25: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/networking/only-tls-10-11-12-protocols-supported-systemnetservicepointmanager.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/security/cspparametersparentwindowhandle-now-expects-hwnd-value.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/wf/workflow-30-types-are-obsolete.md: 9: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/retargeting/wf/workflow-30-types-are-obsolete.md: 9: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/includes/migration-guide/runtime/runtime/improved-wcf-chain-trust-certificate-validation-for-nettcp-authentication.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/dotnet-docs/samples/snippets/core/tutorials/netcore-hosting/csharp/HostWithHostFxr/readme.md: 3: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
--- a/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap
+++ b/test/snapshots/markdownlint-test-repos-dotnet-docs.mjs.snap
--- a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.md
+++ b/test/snapshots/markdownlint-test-repos-mdn-content.mjs.md
@ -8,4 +8,67 @@ Generated by [AVA](https://avajs.dev).

 > Expected linting violations

-    ''
+    `test-repos/mdn-content/files/en-us/glossary/media_query/index.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/css_layout/fundamental_layout_comprehension/index.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/scripting/functions/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/structuring_content/creating_links/index.md: 255: MD059/descriptive-link-text Link text should be descriptive [Context: "[Click here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/core/styling_basics/box_model/index.md: 293: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/performance/css/index.md: 174: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/performance/multimedia/index.md: 105: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/development_environment/index.md: 225: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/development_environment/index.md: 464: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/django/models/index.md: 491: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/extensions/server-side/express_nodejs/deployment/index.md: 379: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/tools_and_setup/how_much_does_it_cost/index.md: 81: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/tools_and_setup/how_much_does_it_cost/index.md: 81: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/learn_web_development/howto/web_mechanics/what_is_a_domain_name/index.md: 175: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/document_an_http_header/index.md: 21: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 123: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/howto/json_structured_data/index.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md: 458: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/add-ons/webextensions/native_messaging/index.md: 399: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/17/index.md: 39: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/22/index.md: 57: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/29/index.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/3/updating_extensions/index.md: 162: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/mozilla/firefox/releases/44/index.md: 218: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/aria_techniques/index.md: 18: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-disabled/index.md: 115: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-expanded/index.md: 99: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/attributes/aria-haspopup/index.md: 65: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/roles/command_role/index.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/accessibility/aria/roles/index.md: 88: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/mdn-content/files/en-us/web/api/background_fetch_api/index.md: 89: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/filesystem/index.md: 12: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/html_drag_and_drop_api/index.md: 243: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmlanchorelement/index.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmllinkelement/as/index.md: 17: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/htmllinkelement/index.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/media_source_extensions_api/transcoding_assets_for_mse/index.md: 28: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/stylesheet/ownernode/index.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/api/svgaelement/target/index.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/webglrenderingcontext/getextension/index.md: 46: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/api/webglrenderingcontext/getsupportedextensions/index.md: 44: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_any-link/index.md: 66: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`:link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_visited/index.md: 14: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`:link\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/_colon_visited/index.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 131: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/css_media_queries/index.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 18: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/css/justify-items/index.md: 20: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/mdn-content/files/en-us/web/html/attributes/rel/preconnect/index.md: 22: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/html/attributes/rel/preload/index.md: 105: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 54: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/http/headers/sec-purpose/index.md: 92: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/javascript/guide/modules/index.md: 407: MD059/descriptive-link-text Link text should be descriptive [Context: "[\`<link>\`]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/dns-prefetch/index.md: 74: MD059/descriptive-link-text Link text should be descriptive [Context: "[\\<link>]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/speculative_loading/index.md: 50: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/performance/speculative_loading/index.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/mdn-content/files/en-us/web/svg/tutorial/getting_started/index.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/uri/schemes/data/index.md: 27: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/uri/schemes/data/index.md: 27: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mdn-content/files/en-us/web/xml/xpath/guides/introduction_to_using_xpath_in_javascript/index.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`
--- a/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap
+++ b/test/snapshots/markdownlint-test-repos-mdn-content.mjs.snap
--- a/test/snapshots/markdownlint-test-repos-small.mjs.md
+++ b/test/snapshots/markdownlint-test-repos-small.mjs.md
@ -159,19 +159,56 @@ Generated by [AVA](https://avajs.dev).
    test-repos/apache-airflow/clients/python/README.md: 395: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing leading pipe]␊
    test-repos/apache-airflow/clients/python/README.md: 395: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]␊
    test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing leading pipe]␊
-    test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]`
+    test-repos/apache-airflow/clients/python/README.md: 396: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: no_leading_or_trailing; Missing trailing pipe]␊
+    test-repos/apache-airflow/dev/MANUALLY_BUILDING_IMAGES.md: 49: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md: 118: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/dev/PROJECT_GUIDELINES.md: 42: MD059/descriptive-link-text Link text should be descriptive [Context: "[Link]"]␊
+    test-repos/apache-airflow/generated/README.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/apache-airflow/providers/google/tests/system/google/README.md: 77: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

 ## https://github.com/electron/electron

 > Expected linting violations

-    ''
+    `test-repos/electron-electron/CONTRIBUTING.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/app.md: 687: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/app.md: 689: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/session.md: 838: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/printer-info.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/printer-info.md: 10: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/web-preferences.md: 19: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/structures/web-preferences.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/api/web-contents.md: 132: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1147: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1705: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1726: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1830: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/breaking-changes.md: 1978: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 30: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/build-instructions-macos.md: 58: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/creating-api.md: 47: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/creating-api.md: 161: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/development/pull-requests.md: 183: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/electron-timelines.md: 90: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/fuses.md: 141: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/launch-app-from-url-in-another-app.md: 66: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/mac-app-store-submission-guide.md: 63: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/snapcraft.md: 24: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/tray.md: 67: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 104: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 107: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/electron-electron/docs/tutorial/windows-store-guide.md: 137: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

 ## https://github.com/eslint/eslint

 > Expected linting violations

-    ''
+    `test-repos/eslint-eslint/docs/src/extend/custom-rule-tutorial.md: 494: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/extend/custom-rules.md: 141: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/extend/custom-rules.md: 148: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/eslint-eslint/docs/src/integrate/integration-tutorial.md: 278: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

 ## https://github.com/mkdocs/mkdocs

@ -188,6 +225,7 @@ Generated by [AVA](https://avajs.dev).
    test-repos/mochajs-mocha/PROJECT_CHARTER.md: 51: MD051/link-fragments Link fragments should be valid [Context: "[§2: Scope](#%c2%a72-scope)"]␊
    test-repos/mochajs-mocha/PROJECT_CHARTER.md: 56: MD051/link-fragments Link fragments should be valid [Context: "[§2: Scope](#%c2%a72-scope)"]␊
    test-repos/mochajs-mocha/README.md: 39: MD045/no-alt-text Images should have alternate text (alt text)␊
+    test-repos/mochajs-mocha/docs/changelogs/CHANGELOG_V3_older.md: 207: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
    test-repos/mochajs-mocha/docs/index.md: 32: MD051/link-fragments Link fragments should be valid [Context: "[global variable leak detection](#-check-leaks)"]␊
    test-repos/mochajs-mocha/docs/index.md: 33: MD051/link-fragments Link fragments should be valid [Context: "[optionally run tests that match a regexp](#-grep-regexp-g-regexp)"]␊
    test-repos/mochajs-mocha/docs/index.md: 34: MD051/link-fragments Link fragments should be valid [Context: "[auto-exit to prevent "hanging" with an active loop](#-exit)"]␊
@ -212,22 +250,40 @@ Generated by [AVA](https://avajs.dev).
    test-repos/mochajs-mocha/docs/index.md: 2112: MD051/link-fragments Link fragments should be valid [Context: "[Watch mode](#-watch-w)"]␊
    test-repos/mochajs-mocha/docs/index.md: 2399: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "caniuse-notifications"] [Context: "[caniuse-notifications]: https..."]␊
    test-repos/mochajs-mocha/docs/index.md: 2400: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "caniuse-promises"] [Context: "[caniuse-promises]: https://ca..."]␊
-    test-repos/mochajs-mocha/docs/index.md: 2431: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "mocha-website"] [Context: "[mocha-website]: https://mocha..."]`
+    test-repos/mochajs-mocha/docs/index.md: 2431: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "mocha-website"] [Context: "[mocha-website]: https://mocha..."]␊
+    test-repos/mochajs-mocha/docs/index.md: 2200: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/mochajs-mocha/docs/index.md: 2270: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

 ## https://github.com/pi-hole/docs

 > Expected linting violations

-    ''
+    `test-repos/pi-hole-docs/docs/ftldns/configfile.md: 224: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/ftldns/configfile.md: 224: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/dns/upstream-dns-providers.md: 120: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/misc/benchmark.md: 32: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/clients.md: 38: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/dual-operation.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/guides/vpn/openvpn/firewall.md: 61: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/pi-hole-docs/docs/main/prerequisites.md: 15: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]`

 ## https://github.com/v8/v8.dev

 > Expected linting violations

-    `test-repos/v8-v8-dev/src/blog/fast-for-in.md: 271: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Internal method       | Hand..."]␊
+    `test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 75: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 77: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 89: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/adaptor-frame.md: 232: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/fast-for-in.md: 271: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Internal method       | Hand..."]␊
    test-repos/v8-v8-dev/src/blog/fast-for-in.md: 277: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`[[OwnPropertyKeys]]\` | \`own..."]␊
    test-repos/v8-v8-dev/src/blog/fast-for-in.md: 351: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Position | Name             ..."]␊
    test-repos/v8-v8-dev/src/blog/fast-for-in.md: 369: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| 17       | \`ForInFilter\`    ..."]␊
+    test-repos/v8-v8-dev/src/blog/high-performance-cpp-gc.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 13: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 13: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/jspi-ot.md: 38: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/blog/lazy-unlinking.md: 183: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Benchmark    | Kind         ..."]␊
    test-repos/v8-v8-dev/src/blog/lazy-unlinking.md: 188: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| youtube.com  | Average size ..."]␊
    test-repos/v8-v8-dev/src/blog/maglev.md: 143: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Benchmark   | Energy Consump..."]␊
@ -275,6 +331,7 @@ Generated by [AVA](https://avajs.dev).
    test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 139: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`\`\`                         ..."]␊
    test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 185: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| C++                         ..."]␊
    test-repos/v8-v8-dev/src/blog/oilpan-pointer-compression.md: 202: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`\`\`                         ..."]␊
+    test-repos/v8-v8-dev/src/blog/optimizing-v8-memory.md: 35: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/blog/pointer-compression.md: 192: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
    test-repos/v8-v8-dev/src/blog/pointer-compression.md: 193: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
    test-repos/v8-v8-dev/src/blog/pointer-compression.md: 194: MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]␊
@ -307,20 +364,33 @@ Generated by [AVA](https://avajs.dev).
    test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 191: MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "> 7. Return \`NormalCompletion(..."]␊
    test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 113: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Name         | Description  ..."]␊
    test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 117: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| \`[[Target]]\` | Used for dire..."]␊
+    test-repos/v8-v8-dev/src/blog/understanding-ecmascript-part-1.md: 102: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/v8-nodejs.md: 29: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/blog/v8-release-80.md: 46: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "|                       || Des..."]␊
    test-repos/v8-v8-dev/src/blog/v8-release-80.md: 53: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| ^^          | GC       | -7%..."]␊
+    test-repos/v8-v8-dev/src/blog/v8-release-86.md: 16: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/blog/wasm-decompile.md: 153: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/docs/become-committer.md: 34: MD034/no-bare-urls Bare URL used [Context: "v8-committers@googlegroups.com"]␊
    test-repos/v8-v8-dev/src/docs/become-committer.md: 44: MD034/no-bare-urls Bare URL used [Context: "v8-committers@googlegroups.com"]␊
+    test-repos/v8-v8-dev/src/docs/blink-layout-tests.md: 11: MD059/descriptive-link-text Link text should be descriptive [Context: "[more]"]␊
+    test-repos/v8-v8-dev/src/docs/contribute.md: 23: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/docs/cross-compile-arm.md: 21: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 41: MD034/no-bare-urls Bare URL used [Context: "v8-eng-review-owners@googlegro..."]␊
    test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 78: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
    test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 80: MD034/no-bare-urls Bare URL used [Context: "v8-eng-review-owners@googlegro..."]␊
+    test-repos/v8-v8-dev/src/docs/design-review-guidelines.md: 126: MD059/descriptive-link-text Link text should be descriptive [Context: "[Here]"]␊
    test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 7: MD034/no-bare-urls Bare URL used [Context: "syg@chromium.org"]␊
    test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 7: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
    test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 9: MD034/no-bare-urls Bare URL used [Context: "gdeepti@chromium.org"]␊
    test-repos/v8-v8-dev/src/docs/feature-launch-process.md: 9: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
+    test-repos/v8-v8-dev/src/docs/hidden-classes.md: 133: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
    test-repos/v8-v8-dev/src/docs/official-support.md: 19: MD034/no-bare-urls Bare URL used [Context: "v8-dev@googlegroups.com"]␊
    test-repos/v8-v8-dev/src/docs/respectful-code.md: 36: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| Term      | Suggested altern..."]␊
    test-repos/v8-v8-dev/src/docs/respectful-code.md: 45: MD058/blanks-around-tables Tables should be surrounded by blank lines [Context: "| redline   | priority line, l..."]␊
+    test-repos/v8-v8-dev/src/docs/torque.md: 527: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
+    test-repos/v8-v8-dev/src/docs/trace.md: 5: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/v8-v8-dev/src/feature-support.md: 11: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/feature-support.md: 19: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/feature-support.md: 27: MD033/no-inline-html Inline HTML [Element: feature-support]␊
@ -378,6 +448,7 @@ Generated by [AVA](https://avajs.dev).
    test-repos/v8-v8-dev/src/features/promise-finally.md: 82: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/features/regexp-match-indices.md: 134: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/features/regexp-v-flag.md: 254: MD033/no-inline-html Inline HTML [Element: feature-support]␊
+    test-repos/v8-v8-dev/src/features/simd.md: 217: MD059/descriptive-link-text Link text should be descriptive [Context: "[link]"]␊
    test-repos/v8-v8-dev/src/features/stable-sort.md: 76: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/features/stable-sort.md: 84: MD033/no-inline-html Inline HTML [Element: feature-support]␊
    test-repos/v8-v8-dev/src/features/string-matchall.md: 92: MD033/no-inline-html Inline HTML [Element: feature-support]␊
@ -426,6 +497,7 @@ Generated by [AVA](https://avajs.dev).
    test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 63: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhint repo"] [Context: "[webhint repo]: https://github..."]␊
    test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 64: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhint.io"] [Context: "[webhint.io]: https://webhint...."]␊
    test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/local-server.md: 65: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "webhintio repo"] [Context: "[webhintio repo]: https://gith..."]␊
+    test-repos/webhintio-hint/packages/hint/docs/user-guide/development-flow-integration/travis-and-azure.md: 4: MD059/descriptive-link-text Link text should be descriptive [Context: "[here]"]␊
    test-repos/webhintio-hint/packages/hint/docs/user-guide/index.md: 178: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "nodejsdownloadcurrent"] [Context: "[NodejsDownloadCurrent]: https..."]␊
    test-repos/webhintio-hint/packages/hint/docs/user-guide/troubleshoot/summary.md: 137: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "githubwebhintiohint308"] [Context: "[GithubWebhintioHint308]: http..."]␊
    test-repos/webhintio-hint/packages/hint/docs/user-guide/troubleshoot/summary.md: 141: MD053/link-image-reference-definitions Link and image reference definitions should be needed [Unused link or image reference definition: "npmjspackageiltorb"] [Context: "[NpmjsPackageIltorb]: https://..."]␊
--- a/test/snapshots/markdownlint-test-repos-small.mjs.snap
+++ b/test/snapshots/markdownlint-test-repos-small.mjs.snap
--- a/test/snapshots/markdownlint-test-scenarios.mjs.md
+++ b/test/snapshots/markdownlint-test-scenarios.mjs.md
--- a/test/snapshots/markdownlint-test-scenarios.mjs.snap
+++ b/test/snapshots/markdownlint-test-scenarios.mjs.snap
--- a/test/spaces-inside-link-text.md
+++ b/test/spaces-inside-link-text.md
@ -15,3 +15,7 @@
 [ link `link` ](https://example.com/) {MD039}

 [ *link* link ](https://example.com/) {MD039}
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": false
+} -->
--- a/test/spaces_inside_codespan_elements.md
+++ b/test/spaces_inside_codespan_elements.md
@ -70,6 +70,8 @@ text and ``\`code with ignored escaped \` backticks``

 `` ` leading and trailing space allowed for backtick ` `` text `code`

+<!-- markdownlint-disable descriptive-link-text -->
+
 Text [link](https://example.com/link`link) text `code`.

 Text [link](https://example.com/link```link) text ```code```.
--- a/test/spaces_inside_emphasis_markers.md
+++ b/test/spaces_inside_emphasis_markers.md
@ -1,7 +1,5 @@
 # Heading

-<!-- markdownlint-disable-file emphasis-style strong-style -->
-
 Line with *Normal emphasis*

 Line with **Normal strong**
@ -391,3 +389,9 @@ Emphasis <p data="* attribute *">* HTML *</p> {MD033} {MD037}

 Embedded underscore is okay:
 Text _emphas_i_s_ text _emphasis_
+
+<!-- markdownlint-configure-file {
+  "emphasis-style": false,
+  "descriptive-link-text": false,
+  "strong-style": false
+} -->
--- a/test/spaces_inside_link_text.md
+++ b/test/spaces_inside_link_text.md
@ -105,3 +105,7 @@ Wrapped [
 Not a link, just [ text in ] brackets

 Images are ![ not links ](image.jpg)
+
+<!-- markdownlint-configure-file {
+  "descriptive-link-text": false
+} -->
--- a/test/table-content-with-issues.md
+++ b/test/table-content-with-issues.md
@ -1,7 +1,7 @@
 # Table Content With Issues

 | Content                      | Issue           |
-|------------------------------|---------|
+|------------------------------|-----------------|
 | Text                         | N/A             |
 | (link)[https://example.com]  | {MD011}         |
 | <hr>                         | {MD033}         |
@ -9,5 +9,5 @@
 | * emphasis*                  | {MD037}         |
 | __strong __                  | {MD037}         |
 |  ` code`                     | {MD038}         |
-| [link ](https://example.com) | {MD039} |
-| [link]()                     | {MD042} |
+| [link ](https://example.com) | {MD039} {MD059} |
+| [link]()                     | {MD042} {MD059} |
--- a/test/token-map-spans.md
+++ b/test/token-map-spans.md
@ -38,5 +38,6 @@ code

 <!-- markdownlint-configure-file {
  "code-block-style": false,
-  "heading-style": false
+  "heading-style": false,
+  "descriptive-link-text": false
 } -->