現在 AI 界主流使用的 Markdown 文件格式有可能被淘汰？ Anthropic Claude Code 團隊核心工程師 Thariq Shihipar（@trq212）於 5 月 9 日在 X 上發表了一篇題為「Using Claude Code: The Unreasonable Effectiveness of HTML」的長文，短短數小時內瀏覽量突破 200 萬，在技術社群中掀起一波關於「AI Agent 時代該用什麼格式輸出」的熱烈討論。Thariq 在文中大膽主張：與 AI 協作時，應該用 HTML 取代 Markdown 作為主要輸出格式。
Thariq Shihipar 並非一般工程師。他是 Anthropic Claude Code 團隊的核心成員，幾乎所有 Claude Code 的重大功能更新都由他在 X 上首發。在加入 Anthropic 之前，他的履歷相當精彩：MIT Media Lab 出身、曾創辦遊戲公司並在 Y Combinator W20 批次獲得 1700 萬美元融資。他加入 Anthropic 的理由也頗有意思——用他自己的話說叫「AI psychosis」，他深信 Claude Code 就是軟體開發的未來。Claude Code 之父 Boris Cherny 的招人標準是「ex-founder, high agency」（創過業、執行力強），Thariq 正好兩條都中。
進入 Claude Code 團隊後，他同時負責工程、內容與用戶反饋三條線，其中最知名的貢獻是 AskUserQuestion 功能——讓 Claude 在資訊不足時主動提問，而不是胡亂猜測。今年 3 月，他寫了一篇關於 Claude Code 內部如何使用 Skills 的長文，透露 Anthropic 內部有數百個活躍 Skills 在運行，遠比外界想像的多。
Claude Code 核心工程師呼籲：別再寫 Markdown 了，用 HTML 吧
Thariq 坦言，Markdown 曾是好工具，簡單、輕量、跨平台、適合版本控制，Claude 甚至能在 Markdown 裡用 ASCII 碼畫出像樣的圖表。但隨著 AI Agent 能力飛躍，Markdown 的瓶頸越來越明顯：
文件太長無人讀：「超過 100 行的 Markdown 文件我基本不會去讀，更別說讓團隊其他人讀了。」Thariq 直言。
資訊表達力不足： 當 Claude Code 想展示一組設計色板時，它在 Markdown 裡只能憋出 ASCII 字元拼成的灰撲撲方塊：Hex 色碼標得很準，但視覺上根本無法辨識。同一份資訊換成 HTML 輸出後，變成清晰可辨的彩色色塊，一目瞭然。
分享麻煩： Markdown 檔案無法在瀏覽器中直接渲染，只能當作附件寄送。HTML 檔上傳到 S3 後分享連結，任何人在任何裝置上都能直接開啟。
最大優勢正在消失： Markdown 最大的優點是「人好編輯」，但隨著 AI 越強，使用者越來越少手動編輯這些檔案，都是讓 AI 去修改。這個優勢基本上已經失效。
為什麼是 HTML？
Thariq 從五個面向論證 HTML 的優勢：
資訊密度。 HTML 能承載的資訊遠比 Markdown 豐富。除了基本的標題與格式化，HTML 還能表達：表格資料（table）、設計資料（CSS）、插圖（SVG）、程式碼片段（script 標籤）、互動元素（JavaScript）、工作流程圖、空間資料（絕對定位 + canvas）以及圖片。Thariq 甚至說：「幾乎沒有什麼資訊是 Claude 能讀懂但 HTML 表達不了的。」
視覺清晰度與可讀性。 Claude 可以用 Tab 分組、插圖輔助、超連結導航，把 HTML 文件的結構組織得更容易瀏覽，甚至可以做成響應式設計。
方便分享。 HTML 檔案上傳後即可分享連結，同事不用安裝任何工具就能在瀏覽器中閱讀。
雙向互動。 這是 HTML 最殺手級的應用，你可以在文件上加滑桿調整設計參數、加按鈕將調整複製成 Prompt 貼回 Claude Code，甚至讓文件變成一個可操作的 Playground。
數據攝入能力。 選擇 Claude Code（而非 Claude.ai 或 Claude Design）來生成 HTML，最大的原因是 Claude Code 能攝入的上下文多得多——檔案系統、MCP 工具（Slack、Linear）、瀏覽器、Git 歷史等。
實戰：五大場景與 20 個開源範例
Thariq 將自己和團隊用 Claude Code 生成的 20 個 HTML 檔案全部開源在 GitHub Pages（thariqs.github.io/html-effectiveness），按用途分為九大分類，以下是最核心的五個場景：
規格規劃與探索。 不再寫一份簡單的 Markdown 方案，而是生成一整組 HTML 檔案：先讓 Claude Code 針對不同選項進行腦力激盪，再深入展開做 Mockup，最後寫實施方案。驗證 Agent 讀入這些 HTML 後，對需求的上下文理解也會更全面。
PR 總結。 與其叫 Claude「用 Markdown 總結這個 PR」，不如叫它「生成一份自包含的 HTML PR 導覽，用內嵌註解渲染重要 Diff 區域，按嚴重程度用顏色標記，底部加上手動驗證清單」。這給審查者的是一個聚焦的審查介面，而不是一堵項目符號牆。
程式碼審查與理解： 用 HTML 渲染程式碼差異，提升程式碼審查效果。
設計與原型互動：HTML 可以快速勾勒設計圖、展示佈局與互動效果，甚至加上參數調整滑桿。
輸出清晰易讀的報告：將複雜分析結果做成可導航的 HTML 報告。
觀點交鋒：HTML 真的能取代 Markdown 嗎？
當然，這並非一面倒的支持。一些開發者指出，Markdown 在輕量快速記錄、Git 版本控制差異比對、以及純文字可攜性方面仍有不可取代的優勢。也有觀點認為，這更像是「工具選擇」的問題：輸出給人看的時候用 HTML，需要逐行維護的規格文件繼續用 Markdown，兩者各有適用場景。值得注意的是，就在幾個月前，Cloudflare 才推出了「Markdown for Agents」功能，從源頭將 HTML 網頁內容轉換為更適合 AI 爬蟲的 Markdown 格式，這說明即使在同一波 AI Agent 浪潮中，Markdown 與 HTML 各有其無可取代的位置。
如何開始？
Thariq 建議不要急著做一個「always respond in HTML」的 Skill。關鍵是理解你想讓這個 Artifact 做什麼、打算怎麼用。直接從簡單的 Prompt 開始：「幫我做一個 HTML 檔案」「做一個 HTML artifact」，在不同場景下慢慢摸索用法。隨著經驗積累，自然會找到最適合自己的工作流程。