///// Checks / Readability
Markdown alternate link
Whether pages point to their Markdown version with a rel=alternate link or an HTTP Link header, and whether that target serves Markdown.
- Check id
markdown-link-alternate- Pillar
- Readability
- Runs in
- The free CLI
- Scoring
- Bonus
- Status
- Pre-release, in calibration
Why it matters
It tells an agent the clean version exists before it parses the HTML.
How to pass
Add <link rel="alternate" type="text/markdown" href="…"> to each page that has a Markdown version.
Run it
Find markdown-link-alternate in the report. Add --md for a fix prompt you can paste into Claude Code, Codex or Cursor.