通过HTTP Accept标头直接向AI Agent提供Markdown内容的方案实践

acceptmarkdown.com 提出一种通过 HTTP Accept 标头向 AI Agent 返回 Markdown 内容的实践：同一个网址根据客户端偏好提供 HTML 或 Markdown；其关注价值在于，网站可以在保留浏览器页面的同时，为代理和检索程序提供更少布局噪声的文本表示。

• 方案的核心是内容协商：服务器读取 Accept 标头，在客户端优先请求 text/markdown 时返回 Markdown，否则继续返回 HTML。网站给出的快速入门页面明确建议按 q 值和媒体类型特异性解析标头，而不是简单进行字符串匹配。
• 返回内容时需要同步设置 Content-Type，且应加入 Vary: Accept，让缓存系统区分 HTML 与 Markdown 两种响应。否则可能出现代理请求拿到错误格式的缓存问题。
• 网站还建议在无法满足客户端明确要求时返回 406，而不是静默降级。这一做法符合 HTTP 内容协商的语义，但实际采用时仍需考虑旧客户端兼容性。
• Cloudflare 文档在2026年7月13日更新的说明显示，其 Markdown for Agents 功能也使用 Accept: text/markdown，并在响应中提供估算的 Markdown 与原始 HTML token 数；该服务只转换 HTML，源站响应还受到 2 MB 限制。
• 该方案主要优化抓取、解析和上下文输入效率，并不自动提高内容准确性、搜索排名或模型推理质量。Markdown 转换仍可能丢失交互组件、视觉层级和部分语义，网站需要自行测试表格、代码、链接及结构化数据的保留情况。
• 影响/看点：若更多代理开始发送这一标头，内容协商可能成为网站面向机器访问的实用接口；收益能否成立，取决于代理是否真正请求 Markdown、转换结果是否完整，以及 CDN 和缓存是否正确处理 Vary: Accept。
• 资料依据：acceptmarkdown.com《Quick start》，页面访问于2026年8月26日，https://acceptmarkdown.com/start；Cloudflare《Markdown for Agents》，更新于2026年7月13日，https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/；Ben Word《Serving Markdown to AI Agents via Accept Headers》，2026年4月18日，https://benword.com/serving-markdown-to-ai-agents-via-accept-headers

本内容由 AI 生成，仅供参考，请注意甄别