# Markdown twin

URL: https://xodia.ai/glossary/markdown-twin
Description: Markdown twin explained: what it is, why it matters and how Xodia uses it, with links to the Xodia features and guides that cover it.
Last updated: 2026-11-08

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 November 8, 2026

## 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

- [Agent skills](https://xodia.ai/product/agents)
- [What an AI website builder is](https://xodia.ai/ai-website-builder)

## Related terms

- [llms.txt llms.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.](https://xodia.ai/glossary/llms-txt)
- [Canonical URL A 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.](https://xodia.ai/glossary/canonical-url)
- [Structured data Structured 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.](https://xodia.ai/glossary/structured-data)

[See every term in the glossary](https://xodia.ai/glossary)

Glossary