作者: Evil Martians
随着自主 Agent(如 Claude Code, Cursor)在开发者工作流中成为标配,技术文档的设计范式也必须转型。Evil Martians 团队发布的指南详述了面向开发机器人的具体内容优化方案。
AI 编码代理在网络抓取时,会在其请求标头(Header)中主动传入 Accept: text/markdown。因此,建立无冗余、纯 Markdown 格式的技术文档渲染出口,是大模型时代开发者页面的标配。
为了让爬虫在抓取 HTML 的同时,立即发现对应的 Markdown 精简版地址,推荐在 HTML 的 <head> 中增加 alternate 指引:
<link rel="alternate" type="text/markdown" href="/docs/guide.md" />