別再拿 Markdown 和 HTML 對比了，這倆根本不是同一個賽道。
整理版優先睇
Markdown適合輸入、HTML適合輸出，兩者唔係同一賽道
呢篇文章嘅出發點係Anthropic Claude Code團隊工程師Thariq Shihipar嘅帖子《The Unreasonable Effectiveness of HTML》，當中提到團隊內部已經用HTML取代Markdown作為AI嘅主要輸出格式。作者認為好多人讀完之後問「Markdown係咪要被取代？」呢個問題本身就問錯咗，因為Markdown同HTML根本唔係同一場比賽嘅對手。核心結論係：輸入用Markdown，輸出用HTML，各司其職先係正解。
Markdown喺輸入側嘅優勢好實在：省token（通常係HTML嘅1/2至1/3）、易維護、版本控制友好，而且大模型喺Markdown語料上訓練充足，理解冇損耗。所以不論係提示詞、知識庫定係設計註釋，用Markdown寫都係最慳力又最準確嘅選擇。
HTML喺輸出側就展現出截然不同嘅價值：佢提供空間結構而唔係線性文字流，可以並排對比方案、用Tab摺疊資訊、內聯SVG圖形，甚至支援交互動效。雖然生成成本係Markdown嘅2至4倍，但而家上下文窗口動輒幾十上百萬token，「省token」已經唔係首要考慮，「易讀直觀」先係。所以AI輸出應該用HTML，令產出物真正可交付、可互動、可被下一個Agent讀取。
- Markdown喺輸入側無可替代：省token、易版本控制、模型理解準確，適合提示詞同知識庫。
- HTML喺輸出側睇高一線：空間結構、可交互、SVG、Tab摺疊，資訊密度同可讀性遠超線性文字。
- 兩者比較：消耗token、版本控制、可讀性、交互能力、維護成本各有優劣，適合唔同環節。
- 啟發：唔好盲目追捧某種格式，要根據工作流輸入/輸出場景選擇最適合嘅工具。
- 可行動點：喺prompt末尾加一句「輸出為自包含HTML文件」，即可輕鬆切換。
The Unreasonable Effectiveness of HTML 示例頁
Thariq團隊公開嘅20個HTML輸出示例，展示方案對比、代碼審查、技術講解等場景。
Thariq Shihipar 嘅 X 帖子
引發討論嘅原帖，講述HTML喺AI輸出側嘅優勢。
Markdown嘅真正戰場：輸入側
Markdown原本就係為人類手寫內容設計，簡潔、純文字、版本控制友好。將佢作為AI工作流嘅輸入格式，好處係真實存在嘅。
省Token：同一份內容，Markdown消耗通常只有HTML嘅1/2到1/3
易維護易版本控制：diff乾淨、git審查友好、grep直接
模型讀得準：大語言模型喺Markdown語料上訓練充分，結構識別穩定
HTML嘅殺手鐧：輸出側空間界面
Markdown渲染之後係線性文字流，篇幅長就好易被跳過；HTML輸出就係空間化界面，信息組織方式完全唔同。
- 1 空間結構：方案對比可以並排，唔使靠大腦diff兩段文字
- 2 交互功能：動效、Tab、摺疊、滑塊、可拖拽，五秒展示嘅內容文字做唔到
- 3 SVG圖形原生支持：流程圖、架構圖、數據圖表直接內聯，唔使再話「呢度應該有張圖」
- 4 可被喂回模型：HTML輸出可以直接作為下一條prompt嘅輸入，形成閉環
生成成本係Markdown嘅2至4倍，但而家最優解已經變成「易讀直觀」
點樣喺工作流入面切換兩種格式？
輸入側繼續用Markdown，輸出側只需喺prompt末尾加一句指定格式，就能得到完全唔同嘅產出物。
- 方案對比：Give me a side-by-side comparison of three approaches with trade-offs called out inline. Output as a self-contained HTML file.
- 代碼審查：Help me review this PR. Render the diff with inline annotations, color-code findings by severity. Output as a self-contained HTML file.
- 技術講解：Explain [concept] with a TL;DR box, collapsible steps, tabbed code snippets, and a hover-linked glossary. Output as a self-contained HTML file.
呢三個例子嘅完整輸出可以睇 thariqs.github.io/html-effectiveness
背後更大嘅趨勢：AI由生成文本走向生成Artifacts
Thariq嘅帖子之所以引起討論，唔係因為「HTML比Markdown好」，而係觸到一個大轉變：AI正從「生成文本」演進到「生成可交互Artifacts」。
聊天框係為對話設計嘅，唔係為交付設計
HTML文件係自包含、瀏覽器直開，可以獨立存在、可以被修改、可以被下一個Agent讀取、三個月後打開仲睇得明
歡迎喺評論區分享你喺工作流入面點樣用呢兩種格式。
AI 工作流程 · 格式嘅爭論
Markdown 同 HTML
本質上係唔同目標底下嘅兩種語言
輸入用 Markdown，輸出用 HTML，各自做返自己嘅嘢先係正確做法。
上個禮拜，Anthropic Claude Code 團隊工程師 Thariq Shihipar 出咗一篇帖，個標題叫《The Unreasonable Effectiveness of HTML》，中文翻譯係：《HTML 勁到冇朋友》。仲有 20 個示範文件，話團隊內部已經用 HTML 取代 Markdown 做 AI 嘅主要輸出格式。
好多人睇完第一個反應係：「Markdown 係咪要被取代？」
但我覺得呢個問題本身就問錯咗。Markdown 同 HTML 從來唔係同一場比賽嘅對手，佢哋服務嘅係工作流程入面完全唔同嘅兩個環節。
Markdown 更適合「輸入」
Markdown 最初係為人類手寫內容設計嘅，簡潔、純文字、版本控制友好。將佢作為 AI 工作流程嘅輸入側格式，優勢係真實存在嘅：
慳 Token
同一份內容，Markdown 嘅 token 消耗通常只有 HTML 嘅一半甚至三分一。早期嘅 GPT-4 得 8192 token 上下文，所以 Markdown 係工程上完全合理嘅選擇，慳落嚟嘅 token 預算可以塞多啲有效資訊。
易維護、易版本控制
Markdown 文件 diff 乾淨，git 審查友好，grep 搜尋直接，任何編輯器打開就改得。HTML 一旦帶上樣式，diff 噪音大，維護成本高好多。
模型讀得準，理解冇損耗
大語言模型喺 Markdown 語料上訓練充足，結構識別穩定。背景文件、知識庫、README、設計註釋用 Markdown 餵入去，模型嘅理解效率更高，唔會因為標籤解析分心。
寫提示詞嘅原生語言
System prompt、Skills、用戶個性化指令、上下文片段，用 Markdown 寫結構清晰，人類容易改，模型容易明，改咗之後即刻睇到效果。呢個係提示詞工程入面嘅事實標準。
總結：Markdown 嘅優勢在於寫同維護嗰邊。人寫得快，機器讀得準，改起嚟平，呢三點喺輸入環節都係實實在在嘅價值。
HTML 點解適合「輸出」
問題出喺輸出嗰邊。
Markdown 渲染之後對短內容來講幾好睇，但 AI 生成嘅輸出隨時幾百行，渲染之後依然係一堵由上到下嘅線性文字流，冇層級，冇跳轉，冇互動空間。人類面對呢種輸出，通常掃一眼然後關咗佢，好少真係睇完。
Thariq 嘅觀察就在呢度：Markdown 渲染得再好，都只係「格式化嘅文字」；HTML 嘅輸出就可以係「空間化嘅界面」。兩者嘅差距唔在於視覺美觀，而在於資訊嘅組織方式。
空間結構，而唔係線性流
方案對比可以並排，唔使靠大腦 diff 兩段文字。代碼 diff 可以帶邊注同嚴重程度染色，一眼睇出應該 focus 邊度。資訊可以分層，用 Tab、摺疊、跳轉連結組織，讀者自己揀深度。
互動，而唔係靜態文字
動效同互動只能夠被感受，冇辦法被描述。一個帶真實緩動曲線嘅動畫沙盒，五秒話俾你知嘅嘢，成段文字做唔到。一致性哈希講解配上可以加減節點嘅互動環，比任何文字直觀。
SVG 圖形原生支援
Markdown 入面嵌唔到矢量圖，HTML 入面 SVG 係一等公民。AI 可以直接內聯繪製流程圖、架構圖、數據圖表，而唔係得用文字描述「呢度應該有一張圖」。
可以被餵返入去，形成閉環
HTML 輸出可以直接作為下一條 prompt 嘅輸入，亦可以被其他 Agent 讀取，充當「共享記憶體」。一個渲染出來嘅色板，比一個 JSON token 清單，更容易令人指住話「改呢度」，然後繼續做嘢。
生成成本係 Markdown 嘅 2 到 4 倍，但係喺上下文窗口隨時幾十上百萬 token 嘅今日，「慳 token」唔再係輸出格式嘅第一優先級，「易讀直觀」先係。限制變咗，最優解自然都變咗。
核心觀點
輸入用 Markdown，輸出用 HTML。
前者慳 token、易維護、方便人改同機器讀；後者可視化、可互動、空間化，形成真正可以交付嘅產出物。兩者各有擅長嘅環節，冇邊個絕對好，都冇邊個絕對差。
橫向對比
喺工作流程入面點樣切換
輸入側繼續用 Markdown，輸出側只需要喺 prompt 尾加一句話，就可以拎到完全唔同嘅產出物：
方案對比
Give me a side-by-side comparison of three approaches with trade-offs called out inline. Output as a self-contained HTML file.
幫我並排對比三種方案，將權衡點內聯標註出嚟。輸出為單文件 HTML，可以直接喺瀏覽器打開。
完整例子：thariqs.github.io/html-effectiveness/01-exploration-code-approaches.html
代碼審查
Help me review this PR. Render the diff with inline annotations, color-code findings by severity. Output as a self-contained HTML file.
幫我審查呢個 PR。將 diff 渲染出嚟，帶邊注，按嚴重程度染色。輸出為單文件 HTML。
完整例子：thariqs.github.io/html-effectiveness/03-code-review-pr.html
技術講解
Explain [concept] with a TL;DR box, collapsible steps, tabbed code snippets, and a hover-linked glossary. Output as a self-contained HTML file.
解釋 [概念]，包含 TL;DR 摘要框、可摺疊步驟、tabbed 代碼示例同 hover 聯動詞彙表。輸出為單文件 HTML。
完整例子：thariqs.github.io/html-effectiveness/15-research-concept-explainer.html
呢場討論背後更大嘅趨勢
Thariq 嘅帖之所以能夠引爆討論，唔係因為「HTML 比 Markdown 好」呢句話有幾驚人，而係因為佢觸及到一個更大嘅轉變：AI 正喺度由「生成文字」向「生成可互動 Artifacts」演進。
聊天框係一種界面，但佢係為對話設計嘅，唔係為交付設計嘅。當 AI 要畀你一份規劃、一個組件庫、一篇審查報告時，對話框係一個差勁嘅展示容器，將所有嘢都壓平成一條消息流。
HTML 文件係單文件、自包含、瀏覽器直開，佢唔係聊天記錄，佢係一個可以獨立存在嘅產出物，可以俾人修改，可以被下一個 Agent 讀取，可以直接發畀協作者，三個月後打開仲睇得明。Markdown 喺輸入側依然無可取代，但喺輸出側，佢從來都唔係終點。
Markdown 唔會死。佢喺自己擅長嘅地方，依然係最省力嘅選擇。
但如果你仲用緊 Markdown 接收 AI 嘅長篇輸出，不妨換一次格式試嚇。分別唔在於「邊個格式更好」，而在於「呢個場景下用呢個效率會更高」。
你喺實際工作流程入面點樣用呢兩種格式？歡迎喺評論區傾嚇。
參考來源：
· The Unreasonable Effectiveness of HTML
— thariqs.github.io/html-effectiveness
· Thariq's Post on X
— x.com/trq212/status/2052809885763747935
AI 工作流 · 格式之爭
Markdown 與 HTML
本質是不同目標下的兩種語言
輸入用 Markdown，輸出用 HTML，各司其職才是正解。
上週，Anthropic Claude Code 團隊工程師 Thariq Shihipar 發了一篇帖子，標題叫《The Unreasonable Effectiveness of HTML》，中文翻譯：《HTML 強得沒邊》。配套 20 個示例文件，說團隊內部已經在用 HTML 替代 Markdown 作為 AI 的主要輸出格式。
很多人讀完的第一反應是：「Markdown 要被取代了嗎？」
但我覺得這個問題本身就問錯了。Markdown 和 HTML 從來不是同一場比賽裏的對手，它們服務的是工作流裏完全不同的兩個環節。
Markdown 更適合「輸入」
Markdown 最初是為人類手寫內容設計的，簡潔、純文本、版本控制友好。把它作為 AI 工作流的輸入側格式，優勢是真實存在的：
省 Token
同一份內容，Markdown 的 token 消耗通常只有 HTML 的 1/2 甚至 1/3。早期的 GPT-4 只有 8192 token 上下文，所以 Markdown 是工程上完全合理的選擇，省下來的 token 預算可以塞更多有效信息。
易維護、易版本控制
Markdown 文件 diff 乾淨，git 審查友好，grep 搜索直接，任何編輯器打開就能改。HTML 一旦帶上樣式，diff 噪音大，維護成本高得多。
模型讀得準，理解無損耗
大語言模型在 Markdown 語料上訓練充分，結構識別穩定。背景文檔、知識庫、README、設計註釋用 Markdown 喂進去，模型的理解效率更高，不會因為標籤解析分心。
寫提示詞的原生語言
System prompt、Skills、用戶個性化指令、上下文片段，用 Markdown 寫結構清晰，人類好改，模型好懂，改了之後立刻能看到效果。這是提示詞工程裏的事實標準。
總結：Markdown 的優勢在於寫和維護的一側。人寫得快，機器讀得準，改起來便宜，這三點在輸入環節都是實打實的價值。
HTML 為什麼適合「輸出」
問題出在輸出側。
Markdown 渲染之後對短內容來說很好看，但 AI 生成的輸出動輒幾百行，渲染後依然是一堵從上到下的線性文字流，沒有層級，沒有跳轉，沒有可交互的空間。人類面對這種輸出，往往掃一眼然後關掉，很少真正讀完。
Thariq 的觀察就在這裏：Markdown 渲染得再好，也只是「格式化的文字」；HTML 的輸出則可以是「空間化的界面」。二者的差距不在於視覺美觀，而在於信息的組織方式。
空間結構，而不是線性流
方案對比可以並排，不用靠大腦 diff 兩段文字。代碼 diff 可以帶邊注和嚴重程度染色，一眼看出應該 focus 哪裏。信息可以分層，用 Tab、摺疊、跳轉連結組織，讀者自己選擇深度。
交互，而不是靜態文本
動效和交互只能被感受，不能被描述。一個帶真實緩動曲線的動畫沙盒，五秒告訴你的東西，整段文字做不到。一致性哈希講解配上可以加減節點的交互環，比任何文字直觀。
SVG 圖形原生支持
Markdown 裏嵌不了矢量圖，HTML 裏 SVG 是一等公民。AI 可以直接內聯繪製流程圖、架構圖、數據圖表，而不只是用文字描述「這裏應該有一張圖」。
可以被喂回，形成閉環
HTML 輸出可以直接作為下一條 prompt 的輸入，也可以被其他 Agent 讀取，充當「共享內存」。一個渲染出來的色板，比一個 JSON token 清單，更容易讓人指着說「改這裏」，然後繼續工作。
生成成本是 Markdown 的 2 到 4 倍，但在上下文窗口動輒幾十上百萬 token 的今天，「省 token」不再是輸出格式的第一優先級，「易讀且直觀」才是。約束變了，最優解自然也變了。
核心觀點
輸入用 Markdown，輸出用 HTML。
前者省 token、易維護、便於人改和機讀；後者可視化、可交互、空間化，形成真正可交付的產出物。二者各有擅長的環節，沒有誰絕對好，也沒有誰絕對壞。
橫向對比
在工作流裏怎麼切換
輸入側繼續用 Markdown，輸出側只需在 prompt 末尾加一句話，就能拿到完全不一樣的產出物：
方案對比
Give me a side-by-side comparison of three approaches with trade-offs called out inline. Output as a self-contained HTML file.
幫我並排對比三種方案，把權衡點內聯標註出來。輸出為單文件 HTML，可直接在瀏覽器打開。
完整示例：thariqs.github.io/html-effectiveness/01-exploration-code-approaches.html
代碼審查
Help me review this PR. Render the diff with inline annotations, color-code findings by severity. Output as a self-contained HTML file.
幫我審查這個 PR。把 diff 渲染出來，帶邊注，按嚴重程度染色。輸出為單文件 HTML。
完整示例：thariqs.github.io/html-effectiveness/03-code-review-pr.html
技術講解
Explain [concept] with a TL;DR box, collapsible steps, tabbed code snippets, and a hover-linked glossary. Output as a self-contained HTML file.
解釋 [概念]，包含 TL;DR 摘要框、可摺疊步驟、tabbed 代碼示例和 hover 聯動詞彙表。輸出為單文件 HTML。
完整示例：thariqs.github.io/html-effectiveness/15-research-concept-explainer.html
這場討論背後更大的趨勢
Thariq 的帖子之所以能引爆討論，不是因為「HTML 比 Markdown 好」這句話有多驚人，而是因為它觸到了一個更大的轉變：AI 正在從「生成文本」向「生成可交互 Artifacts」演進。
聊天框是一種界面，但它是為對話設計的，不是為交付設計的。當 AI 要給你一份規劃、一個組件庫、一篇審查報告時，對話框是個糟糕的展示容器，把所有東西都壓平成一條消息流。
HTML 文件是單文件、自包含、瀏覽器直開，它不是聊天記錄，它是一個可以獨立存在的產出物，可以被人修改，可以被下一個 Agent 讀取，可以直接發給協作者，三個月後打開還看得懂。Markdown 在輸入側依然無可替代，但在輸出側，它從來就不是終點。
Markdown 不會死。它在自己擅長的地方，依然是最省力的選擇。
但如果你還在用 Markdown 接收 AI 的長篇輸出，不妨換一次格式試試看。區別不在於「哪個格式更好」，而在於「這個場景下用這個效率會更高」。
你在實際工作流裏怎麼用這兩種格式？歡迎在評論區聊聊。
參考來源：
· The Unreasonable Effectiveness of HTML
— thariqs.github.io/html-effectiveness
· Thariq's Post on X
— x.com/trq212/status/2052809885763747935