面向智能体的 Markdown 版本已损坏
简短回答
页面通过响应 Accept: text/markdown 或通过 <link rel="alternate" type="text/markdown"> 向智能体提供 Markdown 版本,但该版本返回错误、空内容或 HTML 页面。请求它的智能体得不到任何有用的东西。
含义
页面向智能体提供 Markdown(作为对 Accept: text/markdown 的响应,或作为链接的副本),但返回的是错误、空内容或 HTML 页面。
为什么这对 AI 搜索很重要
看到 Markdown 链接或收到 text/markdown 响应的智能体会信任它,可能不会再回退到 HTML。损坏的副本比没有副本更糟:智能体要么失败,要么把错误页面当成你的内容来读。
这通常发生在迁移或重建之后:.md 文件没有部署,重写规则指向旧路径,或者某个中间件给 HTML 打上了 text/markdown 标签。
如何修复
- 打开证据中的 URL,查看状态码、
Content-Type和正文。 - 如果副本已不存在,就重新部署,或删除指向它的
<link rel="alternate" type="text/markdown">标签和Link标头。 - 如果响应是 HTML 或为空,就修复转换逻辑,让它以
Content-Type: text/markdown将页面文本作为 Markdown 返回。 - 在页面报告中点击“再次检测”确认结果。
示例
curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept 如何确认修复
修改后,在报告上点击“再次检测”:它会列出已修复的内容以及评分的变化。