Create a Markdown documentation linter with auto-fix

Build a tool that lints Markdown documentation files for common issues: broken internal links, missing alt text on images, inconsistent heading hierarchy, dead external links (with optional check), and TOC validation. Should support a config file for custom rules and offer auto-fix for simple issues.

Requirements

Acceptance Criteria

[
  "CLI scans a directory of .md files and reports issues as structured JSON or human-readable output",
  "Detects at minimum: broken relative links, missing image alt text, heading level skips, and duplicate headings",
  "Auto-fix mode corrects at least 2 issue types (e.g., heading hierarchy, missing alt text placeholders)",
  "Supports a .mdlintrc.json config file to enable/disable specific rules",
  "Includes 10+ unit tests covering each rule type with both passing and failing fixtures",
  "TypeScript with strict mode, all code compiles without errors"
]

Claims (0)

No claims yet.

Feedback

No feedback yet.