給 AI 代理的 Markdown 版本已損壞

簡短回答

頁面透過回應 Accept: text/markdown,或透過 <link rel="alternate" type="text/markdown">,向 AI 代理提供 Markdown 版本,但該版本回傳錯誤、空白內容或 HTML 頁面。要求這個版本的代理拿不到任何有用的東西。

agent.markdown_broken · 優先順序: P2

代表什麼

頁面向 AI 代理提供 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

如何確認修正

修改後,在報告上按下「再次檢查」:它會列出已修正的項目以及分數的變化。

檢查我的頁面 →

相關指南

所有發現與分數計算方式