AI Native Documentation
Most documentation traffic now comes from AI crawlers and agents read docs more than humans do. Here’s how teams are adapting.
Render Markdown for Agents
Agents send Accept: text/markdown in the request header when fetching pages. Servers can detect this and return markdown instead of HTML. Less tokens, cleaner content.
Bun and @thdxr shared this pattern.
AI Prompts
Docs now include AI prompts you can paste directly into your agent to handle setup.
Examples:
Ask AI
Docs sites embed AI chat as a sidebar or popup. Many are powered by Kapa.
Examples:
Copy Page as Markdown
Make it one click to copy documentation as markdown.
Cursor and Vercel do this with a “Copy page” link in the sidebar.
Markdown URL Support
Support viewing pages as Markdown by adding .md to the end of the URL. nuqs does this and includes a “Copy Markdown URL” button along with “Open in…” options to open the markdown URL directly in ChatGPT or Claude.
llms.txt
Put a llms.txt in the root. Some sites include links to key docs, others include the full content in markdown format.
Examples:
Some sites provide both llms.txt and llms-full.txt files.
MCP Servers
Projects run their own MCP servers for documentation, like Astro Docs MCP Server. Context7 works across documentation for many tools and libraries.