
We made Claude Code and Codex surf docs and counted every 404 they hit before finding the answer.
We served the same content 4 ways: raw HTML, plain markdown, markdown + an llms.txt index, and markdown with the llms.txt inlined on every page.
We found that agents reach for markdown and llms.txt on their own, and HTML-only finished last by a wide margin (15-30x more 404s than markdown + llms.txt).
if you're serious about serving your content to agents, you should be using markdown + llms.txt
markdown + llms.txt mogs html & we have a benchmark that proves it
in september last year, we added support for content negotiation. which means we serve agents markdown instead of html
the initial rollout wasn't great, right after we shipped, @pk_iv noticed it led to claude code 404 hallucinating links for browserbase's docs
we shipped a fix by adding a llms.txt link at the top of the markdown, but were always suspicious it might not be optimal
now we know it actually is! agents want markdown
14
1,267
use @mintlify to update your docs even when you're on a bus!
Developers live in GitHub, so we built Mintlify to live there too.
Here's everything the GitHub App can do
1
11
1,215
Aadit Shah retweeted
I am building a new team at Mintlify, and I am calling for strong engineers to come join me!!
We are looking for folks that want to bring new enterprise product 0->1 at Mintlify.
Strong builders, and ex-founders are perfect for this role. 👌
it's been a blast working on this! our @mintlify agent now has:
- native Slack read tools to pull content directly from your workspace
- time + identity awareness to answer with the right context
- sharper output that stays reliable when it matters most



















