給 AI 代理的 Markdown 版本已損壞
簡短回答
頁面透過回應 Accept: text/markdown,或透過 <link rel="alternate" type="text/markdown">,向 AI 代理提供 Markdown 版本,但該版本回傳錯誤、空白內容或 HTML 頁面。要求這個版本的代理拿不到任何有用的東西。
代表什麼
頁面向 AI 代理提供 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 如何確認修正
修改後,在報告上按下「再次檢查」:它會列出已修正的項目以及分數的變化。