Skip to content

AI · structured authoring · LLM-ready

What LLM-ready content actually means

Vlad Kuzin
On this page

LLM-ready content is documentation structured so language models and AI search can retrieve, cite, and answer from it correctly, and in practice it comes down to three concrete deliverables plus one old discipline. The vendors have converged on three deliverables. Clean markdown versions of every page. llms.txt and llms-full.txt index files. And, where the tooling supports it, a Model Context Protocol server that lets an agent read your docs directly. The discipline underneath is older than all of it: self-contained, well-structured topics. Retrieval happens at the chunk level, not the page level. A section that keeps its meaning outside its page is the section a model quotes without garbling.

One first-party number makes this worth engineering now, rather than waiting out a hype cycle. GitBook, measuring 61.2 million page views across its hosted docs, reported that "AI agents now account for 51.8% of intentional documentation reads on GitBook" in the week of April 27 to May 3, 2026. For documentation specifically, machines are now the majority reader. Everything below is about writing for that reader without giving up the human one.

Machines are now the majority reader of documentation

The majority of documentation reads are already machine reads, but the traffic that flows back from them is small, and both facts have to be held at once. GitBook's 51.8% is the headline for docs. Cloudflare's crawl data names the readers. In its May 2025 measurement of AI-crawler share, GPTBot accounted for 30%, ClaudeBot 21%, Meta-ExternalAgent 19%, Amazonbot 11%, and Bytespider 7.2%. Cloudflare noted that "AI and search crawler traffic grew by 18% from May 2024 to May 2025."

The catch is the return trip. Cloudflare measured it again in the first week of August 2025. It found "Anthropic had the highest crawl-to-refer ratio at nearly 50,000:1, followed by OpenAI at 887:1," with Perplexity at 118:1. It observed that training traffic was "responsible for nearly 80% of the crawling from AI bots." The bots read enormously. They send back almost nothing. The click reality for humans points the same direction. Pew Research covered 68,879 searches, 12,593 of them showing an AI summary. Users clicked a traditional result on 8% of visits when a summary appeared, versus 15% without. They clicked a link inside the summary in just 1% of such visits. They ended the browsing session on 26% of AI-summary pages versus 16% without. Ahrefs, studying 300,000 keywords, found "the presence of an AI Overview in the search results correlated with a 34.5% lower average clickthrough rate (CTR)." Semrush, across more than 50,000 websites for 2025, found AI traffic "grew 66% in 2025 and outpaced every other channel, but it still makes up less than 0.15% of total visits."

What "LLM-ready" concretely means, and what it does not

Strip away the marketing and "LLM-ready" resolves to a specific triad of artifacts plus analytics, which is exactly how the leading docs platforms now define it. The de-facto market definition is markdown mirrors of every page, llms.txt and llms-full.txt files, and an MCP server, with agent-traffic analytics on top.

DeliverableWhat it gives a modelWhere it is proven
Markdown mirror of each pageClean text with no navigation, scripts, or layout noiseGitBook: "all of the pages of your docs site are automatically available as markdown files"
llms.txt / llms-full.txtA curated index (llms.txt) and full-content bundle (llms-full.txt)Mintlify and GitBook auto-host both; Anthropic docs serve one
MCP serverA direct agent read path instead of a scrapeGitBook exposes one "for every published site... no scraping required"
Agent-traffic analyticsVisibility into which agents read which pagesPositioned by Mintlify and GitBook as part of the same offering

The vendor receipts are consistent. Mintlify auto-hosts both files. It describes llms.txt as "an industry standard that helps LLMs index content more efficiently, similar to how a sitemap helps search engines." It positions the file alongside MCP and agent analytics. GitBook states that "all of the pages of your docs site are automatically available as markdown files." It uses llms.txt as the index and llms-full.txt as the full content. It adds that "GitBook automatically exposes a Model Context Protocol (MCP) server for every published site... no scraping required." The pieces map cleanly. Markdown mirrors give a model clean text without HTML noise. llms.txt gives it a curated map of the site. The MCP server gives an agent a direct read path instead of a scrape. Topicary generates the same class of output for its published sites - markdown page serving, llms.txt, and an AI query endpoint. The pattern holds across the newer docs platforms. It is not one vendor's trick.

llms.txt itself is a real proposal, and worth stating precisely rather than mythologizing. Jeremy Howard, co-founder of Answer.AI, published it on September 3, 2024. He proposed "that those interested in providing LLM-friendly content add a /llms.txt file to their site." His stated reason: "the problem this solves is that today, constructing the right context for LLMs based on a website is ambiguous." The format is deliberately minimal: "an H1 with the name of the project or site. This is the only required section," an optional "blockquote with a short summary," and "zero or more markdown sections delimited by H2 headers, containing 'file lists' of URLs where further detail is available." Adoption is genuine on the publisher side. Anthropic's own developer docs serve one that opens "# Anthropic Developer Documentation."

Here is the honest boundary. Adoption by publishers is not consumption by engines. No major engine documents llms.txt as a ranking or citation input. Google's crawler guidance never mentions it. The crawler docs from OpenAI, Anthropic, and Perplexity all control access through robots.txt and say nothing about reading llms.txt. That is an absence of evidence, not proof the file is ignored. The file is also cheap to publish. Ship it as a standard-adjacent courtesy. Expect nothing measurable from it yet.

The louder myth is that AI answers need special markup. They do not. Google states plainly: "You don't need to create new machine readable files, AI text files, or markup to appear in these features. There's also no special schema.org structured data that you need to add," and "there are no additional requirements to appear in AI Overviews or AI Mode, nor other special optimizations necessary." Eligibility is simply that the page is indexed and snippet-eligible in normal Google Search. Schema markup still earns rich results and clarifies entities in classic search. Keep it. Stop treating it as the switch that turns AI answers on.

Why structure wins at retrieval time

Structure wins because retrieval operates on chunks, and a well-formed topic is already a good chunk. Modern AI systems do not read your whole page to answer a question. They split a knowledge base into small pieces, embed them, and pull back the few that match. Anthropic's guidance is to "break down the knowledge base... into smaller chunks of text, usually no more than a few hundred tokens." The failure mode arrives when a chunk loses its meaning outside the page around it.

Anthropic measured the fix directly. Adding context to each chunk before embedding "reduced the top-20-chunk retrieval failure rate by 35% (5.7% → 3.7%)". Combining contextual embeddings with contextual BM25 brought the reduction to 49%. Adding reranking brought it to 67% (5.7% → 1.9%). Those numbers describe a retrieval pipeline. The content-side lesson is exact. Retrieval fails when a chunk cannot stand on its own. The durable fix belongs to the author: write sections that stay meaningful in isolation. A paragraph that opens with "As mentioned above, this setting..." breaks the moment it is retrieved alone.

Structured authoring turns out to have been LLM-ready before LLMs existed. A self-contained topic is the chunk that retrieves cleanly and gets quoted accurately. That means one clear claim per section, a descriptive heading, and no dangling back-references. The GEO research points the same way at the outcome level. The KDD 2024 paper by Aggarwal and colleagues reports that "GEO can boost visibility by up to 40% in generative engine responses." It cautions that "the efficacy of these strategies varies across domains." Forty percent more visibility is the reward for content a generative engine can parse and cite. Component-based, topic-oriented writing produces exactly that shape by default. It is the discipline behind any real structured authoring practice. A component content management system pushes toward it as a side effect. Topicary, like Paligo before it, stores content as self-contained topics and reusable components. That is the same unit a retriever wants to pull back. The deciding factor is the content model, not the model provider. For the deeper argument, see why AI needs structured content.

The three crawler switches

Being LLM-ready also means deciding, per vendor, what the crawlers are allowed to do, because training access, search-index access, and live user fetches are three separate switches controlled in robots.txt per user-agent. Blocking one vendor's single "AI bot" line wholesale is how teams accidentally remove themselves from AI search. They meant to opt out of training. The three intentions are distinct. Each vendor exposes them as distinct agents.

VendorTraining crawlerSearch-index crawlerLive user fetch
OpenAIGPTBot - crawls "content that may be used in training our generative AI foundation models"OAI-SearchBot - "used to surface websites in search results in ChatGPT's search features"ChatGPT-User - fetches pages live when a user asks
AnthropicClaudeBot - collects "web content that could potentially contribute to their training"Claude-SearchBot - "analyzes online content specifically to enhance the relevance and accuracy of search responses"Claude-User - fetches when a user asks
Perplexity(not separately documented)PerplexityBot - "designed to surface and link websites in search results on Perplexity"Perplexity-User - "generally ignores robots.txt rules" because a user requested the fetch

The practical reading of this table is a decision, not a default. To be found in AI search without being used for training, allow OAI-SearchBot and Claude-SearchBot. Disallow GPTBot and ClaudeBot. If you want neither, disallow all of them. The live user-fetch agents behave differently. ChatGPT-User, Claude-User, and especially Perplexity-User act on a person's explicit request. Perplexity documents that its user agent generally ignores robots.txt for that reason. Set each line deliberately, then revisit it. The agent list changes.

A checklist to make a docs site LLM-ready

Making a docs site LLM-ready is a short, ordered checklist, and the content-side items outrank the file-side ones because retrieval quality is decided by the content, not the manifest. Work top to bottom.

  • Write self-contained topics. Each topic answers one question and stands alone. No "as mentioned above" back-references that break when a section is retrieved by itself.
  • Lead each section with a direct answer. State the claim in the first sentence, then support it. This is good technical writing and good chunking at the same time.
  • Use stable, descriptive headings and anchors. Headings are retrieval signals and citation anchors. Keep them concrete. Keep their URLs stable across republishes so a cited link does not rot.
  • Serve a markdown version of every page. Clean markdown removes navigation, scripts, and layout noise, giving a model the text and nothing else.
  • Publish llms.txt (and llms-full.txt). Cheap, standard-adjacent, and the right size for a curated index. Expect no measurable ranking effect yet, and ship it anyway.
  • Expose an MCP server where your platform supports it. This gives agents a direct read path instead of a scrape. It is the fastest-moving part of the triad.
  • Measure agent traffic. You cannot tune what you cannot see. Track which agents fetch which pages so "LLM-ready" is a measured claim, not an aspiration.

Most of this is authoring discipline that a component content management system automates once and enforces everywhere. Topicary published sites ship markdown page serving, llms.txt, and an AI query endpoint as built-in output. The file-side triad is generated rather than hand-maintained. Its structured-authoring model pushes writers toward self-contained topics by design. Mintlify and GitBook do the same file generation well and are strong choices. Pick either one if its reuse and structure model fits how your team already works. Mintlify auto-hosts both files with, in its words, "zero maintenance." GitBook exposes an MCP server for every published site automatically. The contrast worth naming sits at the older end of the tool market. MadCap Flare, as of May 2026, has no built-in LLM-ready output. Reaching parity means a third-party llms.txt plugin priced at $99 a year. The point is not which vendor you pick. The file-side deliverables are now a solved, automatable problem. That puts the weight back where it belongs: on writing topics a model can retrieve and cite. For the underlying content model, start with what a CCMS is and content reuse explained.

FAQ

Frequently asked

What is LLM-ready content?

LLM-ready content is documentation structured so language models and AI search can retrieve, cite, and answer from it correctly. In practice it is three deliverables plus one discipline: clean markdown versions of every page, llms.txt and llms-full.txt index files, and (where available) an MCP server for direct agent access, all sitting on top of self-contained, well-structured topics. The discipline underneath matters most, because retrieval happens at the chunk level, not the page level. A section that keeps its meaning when pulled out of its page is the section a model retrieves and quotes accurately.

What is llms.txt and do AI engines use it?

llms.txt is a proposed file, published September 3, 2024 by Jeremy Howard of Answer.AI, that gives models a curated markdown index of a site: an H1 with the project name, a blockquote summary, and H2 sections listing URLs where further detail lives (llmstxt.org). Adoption on the publisher side is real - Anthropic's developer docs serve one, and Mintlify and GitBook auto-host llms.txt and llms-full.txt for every project. Consumption by the major engines is undocumented: Google's crawler guidance never mentions it, and the crawler docs from OpenAI, Anthropic, and Perplexity control access through robots.txt without documenting any use of llms.txt. Treat it as low-cost and standard-adjacent, not as a proven ranking input.

Does schema.org markup help with AI answers?

Google states directly that no new machine-readable files, AI text files, or special schema.org structured data are needed to appear in AI Overviews or AI Mode (developers.google.com/search/docs/appearance/ai-features). Eligibility comes from the page being indexed and snippet-eligible in normal Google Search. Schema markup still earns rich results in classic search and clarifies entities, so it is worth keeping, but it is not a switch that turns AI answers on or off.

How do I block or allow AI crawlers?

Through robots.txt, per user-agent, because training access, search-index access, and live user fetches are three separate switches per vendor. OpenAI splits GPTBot (training), OAI-SearchBot (search results in ChatGPT), and ChatGPT-User (live user fetches). Anthropic splits ClaudeBot (training), Claude-SearchBot (search relevance), and Claude-User (live fetches). Perplexity runs PerplexityBot (search) and Perplexity-User, which generally ignores robots.txt because a person requested the page. Decide separately whether you want to be trained on, indexed for AI search, and fetched live, then set each agent accordingly.

Does LLM-ready content actually get more traffic?

Not much referral traffic yet, and the honest framing matters. Semrush found AI traffic grew 66% in 2025 and outpaced every other channel, but it still makes up less than 0.15% of total visits. Pew Research found users clicked a link inside an AI summary in just 1% of visits where a summary appeared, and Ahrefs measured a 34.5% lower average clickthrough rate when an AI Overview was present. The payoff of LLM-ready content is not clicks today; it is being the source the model cites correctly rather than the page it paraphrases without attribution. That position compounds as machine readership grows.

Ready to try Topicary?

Start free. No credit card required.