AI finding
A Markdown version the site offers is broken
AI Warning Severity: Low
Part of the audit AI usage signals and agent files. Finding id: ai.markdownVariantBroken.
What it costs you
AI agents that follow the offer get an error, an empty file or HTML they did not ask for, and may skip the page instead of reading the HTML.
What to do
Make the Markdown version answer 200 with the page's text in Markdown, or stop offering it.
What it checks
- Plain text version of page broken
How to fix it
Repair or withdraw the Markdown version
- Find what produces [variant url]: a static .md file, a route, or a plugin that answers Accept: text/markdown.
- Make it return the page's text as Markdown with status 200 and Content-Type text/markdown.
- If you do not want to offer Markdown, remove the link rel=alternate or Link header, or the content negotiation.
How to check: Request [variant url] (or [page url] with Accept: text/markdown): status 200, Markdown text.