Serve pages as markdown and update llms.txt to reference them

[leighmcculloch]

What problem does your feature solve?

When working with AI coding agents, or just as a developer copy-pasting documentation, HTML pages are harder to work with than markdown. HTML contains a lot of markup noise that inflates token counts for agents and loses meaningful structure when pasted into plain-text contexts.

What would you like to see?

Make every documentation page available as a .md file in addition to the HTML version, and update llms.txt to reference the .md URLs instead of HTML pages.

For example, Stripe does this well:

• HTML: https://docs.stripe.com/api/pagination
• Markdown: https://docs.stripe.com/api/pagination.md
• Their llms.txt references the .md files: https://docs.stripe.com/llms.txt

Stripe also has a "View as Markdown" option in the top right of every page, making it easy for developers to grab structured content.

Benefits:

• Markdown retains meaningful structure (headings, code blocks, lists) when copy-pasted
• Significantly reduces token cost when an agent digests a page
• Makes the docs more agent-friendly and automation-friendly

What alternatives are there?

• Developers and agents can scrape the HTML and convert to markdown themselves, but this is error-prone and wasteful.
• A browser extension or external tool could strip HTML, but this adds friction and doesn't help with llms.txt.

[wpalmeri]

I enabled the brand new cloudflare capability to return markdown files when using the Accept: text/markdown header. This works!

We should document in the llms.txt file, maybe call it out on the docs site as well for agentic browsing/consumption.