Cloudflare 在 2026 年 11 月 9 日宣布 Markdown for Agents 正式 GA,並新增 Analytics、抽樣 Logs、Playground、GraphQL Analytics API 與 Cloudflare Traces。這項功能讓支援的網站在收到 Accept: text/markdown 時,由 Cloudflare 將 HTML 即時轉成較精簡的 Markdown;新工具則開始回答更實際的問題:哪些頁面成功轉換、哪些內容被截斷、哪些請求失敗,以及轉換在請求時間線上花了多少資源。

這不是「打開後就會提升 Google 排名」的 SEO 開關,也不是保證所有 AI 助理都會讀取網站。它改變的是內容交付格式與可觀測性:網站可以提供機器較容易解析的版本,並檢查實際轉換品質。是否被搜尋、引用或帶來詢問,仍取決於內容是否可抓取、語意是否清楚、來源可信度、產品資料是否正確,以及各平台自己的索引與排序機制。

新版觀測工具能看見什麼

Dashboard 的 Analytics 會顯示轉換嘗試、完整轉換率、估算 token reduction、部分轉換、未完成或失敗轉換,並可依頁面、user agent、failure reason 與 content limit 檢視。Logs 是抽樣事件,每一列代表估算的請求數,不一定等於一筆原始請求;user agent 也是客戶端自行宣告,不能直接當成已驗證的 AI 機器人身分。

Playground 可對指定 path 發出 Markdown 請求,並排比較 HTML、Markdown、response headers 與估算減量。這很適合上線前驗收:首頁看起來正常,不代表產品頁、文章頁、分頁列表或含大量 JSON-LD 的頁面都能完整轉換。若瀏覽器受 CORS 或網路限制,官方介面會提供可改用的 curl 命令。

需要跨多個 zone 或接既有報表時,可查詢 markdownForAgentsAdaptiveGroups。官方文件指出查詢歷史最長七天、單次窗口最多七天、每個 dataset query 最多 1,000 groups。計數與 token sums 是抽樣加權估算;token savings 也不是以特定模型 tokenizer 精算。它適合看趨勢、找異常頁面,不適合拿來承諾精確的模型費用節省。

先建立一套可回退的導入方式

不要一開始對全站啟用。先選文件、FAQ 或內容結構穩定的文章路徑,用 Configuration Rule 限定 subdomain 或 path。Cloudflare 文件列出的支援方案為 Pro、Business、Enterprise 與 SSL for SaaS 客戶,轉換功能不另收費;但實際帳戶權限與方案仍應在啟用當天確認。

測試時至少覆蓋四種頁面:靜態文章、伺服器渲染商品頁、帶登入或個人化區塊的頁面,以及內容很長或含大量 structured data 的頁面。對每一頁比較標題、段落層級、連結、表格、圖片替代文字、價格與庫存等關鍵欄位。Markdown 轉換會移除導覽、頁尾、script 與 style 等非內容元素,JSON-LD 則會保留在 fenced JSON code block;如果重要資訊只存在互動元件或前端載入後的畫面,就要確認來源 HTML 是否真的包含它。

正式開啟後,先看「Top pages not converted」與 content limits。官方限制包括解壓後 HTML 最多 6 MiB;輸入過大可能截斷,front matter 或 JSON-LD 也可能因內容限制被省略。對電商與在地商家網站,若被省略的是價格、服務區域、營業資訊或商品結構化資料,機器讀到的版本可能和瀏覽器呈現不同,應先縮減不必要 markup,而不是只追求轉換率。

Content-Signal 與快取不能漏看

轉換後會保留 origin 的 HSTS、CSP、CORS、Set-Cookie 與 cache headers。內容 body 雖然改成 Markdown,安全與快取政策不會自動替你重新設計。若同一 URL 依 Accept 回傳 HTML 或 Markdown,回應中的 Vary: accept 很重要;仍要用實際請求確認 CDN、反向代理與自家應用不會把兩種格式混在同一份 cache。

內容使用政策也要主動決定。官方文件說明,若 origin 已提供 content-signal,轉換回應會保留該值;若沒有,Markdown for Agents 會加入預設 ai-train=yes, search=yes, ai-input=yes。這涉及網站是否允許訓練、搜尋與 agent input,不應由工程師在不知道內容授權策略時直接採用預設值。法務、內容與產品負責人應先確認政策,再由 origin 明確輸出 header。

敏感或個人化頁面不適合只因「AI 可讀」就開啟。即使原本需要驗證,仍要測試 Markdown negotiation 是否維持相同的授權、cookie、cache-control 與資料遮罩。robots 控制、WAF、bot policy、登入權限與 Markdown for Agents 是不同層次;啟用轉換不等於允許所有 crawler,也不能替代存取控制。

用 Traces 把失敗定位到請求

Cloudflare Traces 在取樣到 streaming conversion 時,會在 response 下加入 markdown_conversion span,可查看 outcome、輸入與輸出 bytes、converter CPU time、longest slice,以及 input truncated、front matter omitted、JSON-LD omitted 等旗標。span duration 包含等待 origin body 與 downstream backpressure,不能直接解讀成純轉換 CPU 時間;成功完成轉換也不保證內容最後完整送達客戶端。

建議先建立三種排查流程:從 Dashboard 找失敗最多的 path;用 Playground 重現 HTML 與 Markdown 差異;必要時以 Ray ID 進入 Trace 查看轉換 span。每次修正都要同時驗證人類頁面,避免為了讓 Markdown 變短而破壞可及性、結構化資料或正常導覽。

Cloudflare 轉換、自建 Markdown endpoint 或維持 HTML 怎麼選

若網站已在 Cloudflare、內容以公開文章與文件為主,且團隊需要低維運成本,內建轉換與觀測是最直接的試點。若輸出格式需要嚴格 schema、不同角色要看到不同欄位,或內容授權必須逐請求判斷,自建 endpoint 會有更多控制,但也要自行負責同步、快取、監控與安全。結構簡單、現有 HTML 已具良好 heading、metadata、JSON-LD 與可及性的網站,也可以先維持 HTML,不必為了趨勢立即增加另一條交付路徑。

正式採用前的最低清單是:限定試點 path、確認方案與權限、比較 HTML 和 Markdown、檢查 JSON-LD 與重要欄位、設定 Content-Signal、驗證快取與登入邊界、建立七天趨勢基準,並定義何時關閉規則回退。真正值得追的成果不是「估算少了多少 token」,而是重要內容能否完整、正確且依政策被讀取,失敗時團隊能否快速定位與修復。