Markdown 內容協商(content negotiation)
別稱 Accept: text/markdown · Markdown 變體
當用戶端透過 Accept: text/markdown 標頭請求時,提供頁面的乾淨 Markdown 版本。
這是什麼
內容協商是 HTTP 的一種機制:伺服器依請求標頭(主要是 Accept)對同一網址回傳不同的內容表述。Markdown 內容協商是指當用戶端送出 Accept: text/markdown 時,伺服器回傳省 token 的 Markdown 版本,而非完整 HTML。HTML 版本則應以 Vary: Accept 標頭宣告有此替代版本。
為什麼重要
LLM 與 AI 代理解析 Markdown 遠比解析夾雜導覽、廣告與腳本的繁重 HTML 來得可靠,且 Markdown 攝取所需的 token 更少。提供 Markdown 變體等於給答案引擎一份乾淨、無歧義的內容,能提升摘要與引用的準確度。
如何檢查
執行 curl -s -H 'Accept: text/markdown' https://example.com/page,確認回應主體是 Markdown(而非 HTML),且回應標頭為 Content-Type: text/markdown。再與不帶該標頭的一般 curl 比對,驗證伺服器確實依 Accept 分流,並檢查是否有 Vary: Accept 標頭以利快取正確運作。
如何修正
在伺服器或邊緣端加入邏輯,檢查 Accept 標頭並回傳預先儲存或即時產生的 Markdown,附上 Content-Type: text/markdown 與 Vary: Accept。或者另外提供平行的 .md 網址(例如 /page.md)並從 HTML 連結,讓代理能以確定方式抓取乾淨文字。
相關詞彙
- 伺服器端渲染(Server-side rendering, SSR)在初始 HTML 回應中就交付頁面的核心文字與標記,使其不需執行用戶端 JavaScript 即可被讀取。
- llms.txt放在 /llms.txt 的 Markdown 檔案,為 LLM 提供精選的純文字網站地圖,並連結到最重要的內容。
- AI 爬蟲政策(AI-crawler policy)在 robots.txt 中針對 AI 使用者代理(GPTBot、ClaudeBot、PerplexityBot、Google-Extended)設定明確允許或封鎖的規則。
- JSON-LD(結構化資料格式)JSON-LD 是一種以 JSON 為基礎的格式,透過 script type="application/ld+json" 區塊在頁面中嵌入機器可讀的結構化資料,也是 Google 建議用來描述組織、產品、文章等實體的方式。
官方參考資料
外部連結,將於新分頁開啟。
把知識化為行動。
親手逐項完成每一項檢查,並轉成可分享的 GEO Score 報告——或在數秒內自動掃描你的網站。