A plain-text version
Does the site offer its pages as Markdown or plain text, for AI that prefers it?
What we look for
Some sites offer each page in two forms: the usual web page, and a plain Markdown or text version with no layout at all. We look for that in two ways.
- We ask for your home page saying we’d prefer Markdown or plain text. If the server answers with Markdown or plain text instead of HTML, that counts. If it labels the answer as Markdown but sends the HTML page, we say so: that is worse than not negotiating at all, because a reader that asked for Markdown gets HTML as text.
- We guess the usual address for a Markdown copy,
{page}.md, beside the home page (/index.md) or the first page we sampled. If it loads, isn’t empty, and isn’t a web page, that counts. A sampled page that already ends in.mdcounts without a guess. - If you have an
llms.txt, we read the.mdfiles it links (two at most) the same way.
This criterion is still testing: we measure it on every site and show it at the bottom of each report, and it never counts toward the score or appears in Fix first. It’s a young convention, and a well-built HTML page is already readable; a plain-text version is a courtesy, not a requirement.
Why it matters
Markdown is what AI tools write and what many of them prefer to read: just the words and their structure, with no navigation, scripts, or styling to strip away. A few assistants and coding tools already ask for it when it’s offered. When it’s there, they get your content cleanly; when it isn’t, they fall back on your HTML, which is fine if the other Readability criteria pass.
How to pass
There’s nothing to pass. If you want to offer it:
- Publish a Markdown copy of each page beside it, at the same address plus
.md:https://example.com/pricing → the web page https://example.com/pricing.md → the same page, in Markdown - Serve those files as
text/markdown. - Optionally, have the server answer with the Markdown when a request asks for it (
Accept: text/markdown). Some documentation platforms do both for you.
What we expect
No effect on being named, for the same reason as llms.txt: agents that write code ask for it; answer engines don’t.
Evidence
-
Checkly · February 2026 · moderate
Claude Code, Cursor, and OpenCode ask for Markdown when they fetch a page; no answer engine’s crawler is documented to.
Requests from AI agents, tested for what they ask for.
Last changed .