Agents Prefer Markdown Documents
var_epsilon · x · 2026-07-18
A repost discusses a documentation delivery experiment designed for AI agents: implementing content negotiation to "serve Markdown to agents instead of HTML."
The author reviews their practical deployment:
- After supporting content negotiation last September, the system prioritized serving Markdown to agents.
- Initial results weren't perfect; Claude Code previously experienced 404 hallucination links on Browserbase docs.
- They later added an llms.txt link at the top of the Markdown to fix some issues, though they remained unsure if this was the optimal approach.
The conclusion drawn from new benchmarks is that agents do indeed strongly prefer Markdown.
More from coding & agent
- An MCP server signs every AI agent tool call into a verifiable Merkle chain — Funky_Chicken_22 · 2026-07-22
- Annotated transcript of a Claude Code team interview is now available — trq212 · 2026-07-22
- Claude Code skill uses 10 Markdown rules to make outputs ADHD-friendly — alex_verem · 2026-07-22
- BUZZ launches as an open-source group chat layer for teams and agents — Scobleizer · 2026-07-22
- A Firecracker-based platform says it can host 6,000 AI agents on one 256 GB server — maritime_sh · 2026-07-22
- A better path to agent autonomy is running waves, finding friction, and iterating — JnBrymn · 2026-07-22