textlint-rule-link-title-case

textlint rule to enforce AP Style title case for link text and titles in Markdown documents.

Features

• Enforces AP Style title case for link display text, titles, and references
• Handles special terms, acronyms, and technical terminology with proper capitalization
• Supports customization of stop words and special terms
• Provides automatic fixing of improperly cased text

Installation

Install with npm:

1npm install textlint-rule-link-title-case

Usage

Via .textlintrc (recommended):

1{
2  "rules": {
3    "link-title-case": true
4  }
5}

With options:

1{
2  "rules": {
3    "link-title-case": {
4      "stopWords": ["via", "etc"],
5      "specialTerms": {
6        "nextjs": "Next.js",
7        "nestjs": "Nest.js"
8      },
9      "checkLinkTitle": true,
10      "checkLinkText": true
11    }
12  }
13}

Via CLI:

1textlint --rule link-title-case README.md

Options

• checkLinkText: Boolean
  • Default: true
  • Whether to check link display text ([text](url) or [text][reference])
• checkLinkTitle: Boolean
  • Default: true
  • Whether to check link titles ([text](url "title") or [reference]: url "title")
• specialTerms: Object
  • Default: {}
  • Special terms with custom capitalization (e.g., {"nextjs": "Next.js"})
  • In addition of default special terms (see src/ap-style.js file)
• stopWords: string[]
  • Default: []
  • Additional words to treat as stop words (lowercase in titles unless first/last)

Examples

Incorrect

1[click here to learn about javascript](https://example.com)
2
3[Read More About API design](https://example.com "api design principles")
4
5[reference to github][github-link]
6
7[github-link]: https://github.com "github homepage"

Correct

1[Click Here to Learn About JavaScript](https://example.com)
2
3[Read More About API Design](https://example.com "API Design Principles")
4
5[Reference to GitHub][github-link]
6
7[github-link]: https://github.com "GitHub Homepage"

Tips & tricks

Use textlint-filter-rule-comments to disable terminology check for particular paragraphs:

1<!-- textlint-disable link-title-case -->
2
3[Click Here to Learn About JavaScript](https://example.com)
4
5<!-- textlint-enable -->

AP Style Title Case Rules

This rule follows AP Style title case conventions:

• Capitalize the first and last words
• Capitalize all words of four letters or more
• Capitalize nouns, pronouns, adjectives, verbs, adverbs, and subordinating conjunctions
• Lowercase articles (a, an, the), coordinating conjunctions (and, but, or, for, nor), and prepositions of three letters or fewer
• Capitalize a preposition of four or more letters
• Capitalize words following hyphens, colons, em dashes, or other punctuation
• Preserve the capitalization of proper nouns, brand names, and technical terms

Fixable

textlint-rule-link-title-case supports the --fix option.

See https://github.com/textlint/textlint/#fixable for more details.

Running tests

Install just and run validation tests:

1$ just setup
2Installing textlint globally...
3✅ Project setup complete
4$ just validate-all
5Building project...
6Running tests...
7✅ Basic validation complete
8Running e2e lint validation...
9✅ E2E lint validation passed
10Running e2e fix validation...
11✅ E2E fix validation passed
12✅ Full validation complete