面向智能体的 Markdown 版本已损坏

简短回答

页面通过响应 Accept: text/markdown 或通过 <link rel="alternate" type="text/markdown"> 向智能体提供 Markdown 版本,但该版本返回错误、空内容或 HTML 页面。请求它的智能体得不到任何有用的东西。

agent.markdown_broken · 优先级: P2

含义

页面向智能体提供 Markdown(作为对 Accept: text/markdown 的响应,或作为链接的副本),但返回的是错误、空内容或 HTML 页面。

为什么这对 AI 搜索很重要

看到 Markdown 链接或收到 text/markdown 响应的智能体会信任它,可能不会再回退到 HTML。损坏的副本比没有副本更糟:智能体要么失败,要么把错误页面当成你的内容来读。

这通常发生在迁移或重建之后:.md 文件没有部署,重写规则指向旧路径,或者某个中间件给 HTML 打上了 text/markdown 标签。

如何修复

  1. 打开证据中的 URL,查看状态码、Content-Type 和正文。
  2. 如果副本已不存在,就重新部署,或删除指向它的 <link rel="alternate" type="text/markdown"> 标签和 Link 标头。
  3. 如果响应是 HTML 或为空,就修复转换逻辑,让它以 Content-Type: text/markdown 将页面文本作为 Markdown 返回。
  4. 在页面报告中点击“再次检测”确认结果。

示例

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

如何确认修复

修改后,在报告上点击“再次检测”:它会列出已修复的内容以及评分的变化。

检测我的页面 →

相关指南

所有发现及评分计算方式