Markdown twin
A Markdown twin is a plain Markdown version of a web page served alongside the HTML, so AI agents and tools can read the page's content without its layout and scripts.
Updated
On this page
What it is
AI coding agents and crawlers read text more reliably than rendered HTML. A site can serve the same page as Markdown at a parallel address, such as /page.md, or answer with Markdown when a client asks for it with an Accept: text/markdown header.
The HTML page links its twin with rel="alternate", and the twin points back to the HTML as canonical, so search engines don't treat it as duplicate content. A good twin keeps the page's headings, lists and links, and leaves out menus, banners and decorative pictures.
In Xodia
Xodia's agent readiness skill tells your AI how to offer Markdown versions of your pages and to keep them in step when content changes.
Every page of xodia.ai has a Markdown twin, built from the page at build time and linked from its head and from llms.txt.
Read more
Related terms
- llms.txtllms.txt is a plain Markdown file at a site's root, /llms.txt, that tells AI tools what the site is and links to its most useful pages with a line about each.
- Canonical URLA canonical URL is the one address a page declares as its main version, with a link rel="canonical" tag, so search engines combine duplicates under it.
- Structured dataStructured data is machine-readable information about a page, usually JSON-LD in the schema.org vocabulary, that tells search engines and AI tools what the page is about.