Datawhale 乾貨
作者：Thariq，Claude Code 團隊
前天，Claude Code 團隊的 Thariq 寫了一篇文章，標題叫《Using Claude Code: The Unreasonable Effectiveness of HTML》。現在，這篇文章在 X 上已經爆紅，被 780 萬人圍觀，超 2 萬人收藏！
它爆紅的原因，有一個很直接的反直覺觀點：
很多人用 AI，預設會讓它寫 Markdown。寫計劃，用 Markdown；寫總結，用 Markdown；寫 PR 說明，還是 Markdown。
這很合理。Markdown 簡單、穩定、好修改，放在程式碼儲存庫裡也舒服。過去很長一段時間，Markdown 幾乎就是 AI 和人之間最自然的交付格式。
但 Thariq 說，他現在越來越傾向於讓 Claude Code 輸出 HTML，而不是 Markdown。
更有意思的是，他也越來越多地看到 Claude Code 團隊裡的其他人這樣做。
這就讓人好奇了：
Markdown 明明簡單、穩定、好修改，也幾乎是 AI 生成文件的預設格式。為什麼最前沿的一批 Claude Code 團隊成員，反而開始轉向 HTML？
以下是這篇文章的核心內容整理，值得一讀。
Claude Code 團隊的人，開始少用 Markdown 了
Markdown 並沒有壞掉。它依然簡單、便攜、容易編輯，也足夠適合 README、說明文件、程式碼片段和輕量記錄。
Thariq 也承認，Markdown 已經成了 Agent 和人溝通的主流格式。Claude 甚至很擅長在 Markdown 裡用 ASCII 字元畫圖。
但 Claude Code 的使用場景變了。
過去，我們讓 AI 寫 Markdown，是因為它好修改。人可以打開檔案，手動調整幾行，改個標題，刪掉一段說明。
可 Thariq 發現，自己現在越來越少親手編輯這些檔案了。很多 Markdown 並不是拿來手動修改的，而是作為規格說明、參考材料、腦力激盪結果，或者下一步執行計劃。
真要改的時候，他也往往不是自己打開檔案一點點改，而是繼續對 Claude 說：這裡改一下，那裡重寫一下。
這就讓 Markdown 的一個核心優勢變弱了。過去的問題是：這個格式人好不好修改。現在的問題變成了：這個格式人還願不願意讀，能不能快速理解，能不能基於它繼續做判斷。
AI 時代真正的問題是：AI 寫得太多，人不想讀了
這件事真正擊中的，不是「HTML 和 Markdown 誰更好」這種格式爭論，而是一個更普遍的問題：AI 現在太能寫了。
以前我們擔心 AI 寫不出來。現在越來越多時候，它確實寫出來了，而且寫得很完整。
一份實作計劃，可以寫幾百行。一個 PR 解釋，可以把背景、改動、風險、程式碼片段都講一遍。一個技術報告，也可以把上下文、方案、數據、結論全都整理好。
問題是，人真的會讀嗎？
很多人用 AI 的時候，應該都有類似體驗：它生成了一份看起來很完整的 Markdown，你打開掃一眼，覺得大概沒問題，然後就讓它繼續。
不是因為內容一定不好，而是因為它太長、太平、太像一堵文字牆。
Markdown 的表達方式是線性的。標題下面是段落，段落下面是列表，列表下面是程式碼區塊。短的時候很清楚，一長就很考驗人的耐心。
所以核心問題不是 AI 能不能生成文件，而是 AI 生成了這麼多東西之後，人還願不願意讀、看不看得懂、會不會參與判斷。
HTML 和 Markdown 不一樣，它能把 AI 輸出變好讀
一聽到 HTML，很多人第一反應可能是：這不是網頁嗎？
但 Thariq 說的 HTML，不是讓你去寫網頁，也不是讓所有文件都變成網站。它更像是讓 Claude Code 把複雜內容整理成一個更容易進入的頁面。
同樣是一份實作計劃，如果寫成 Markdown，它大機率是一段接一段的標題、列表、程式碼區塊和說明。你要從頭往下讀，才能慢慢拼出整體結構。
但如果寫成 HTML，Claude 可以把不同方案放進分頁（tab），把關鍵流程畫成圖，把程式碼片段放在旁邊，把結論放在前面，把細節折疊起來。
這時你不是在「讀完一份文件」，而是在瀏覽一個已經被組織好的工作台。
這也是 HTML 相比 Markdown 的核心差異：它不只是承載文字，還能承載佈局、圖示、互動和視覺層級。
Thariq 提到，如果沒有 HTML，Claude 有時會在 Markdown 裡很努力地「假裝視覺化」：用 ASCII 字元畫圖，甚至用 Unicode 字元模擬顏色。
這很有趣，也說明 Markdown 本身不太適合承擔複雜視覺表達。與其讓 Claude 在 Markdown 裡將就，不如直接讓它用 HTML 把事情畫出來。
HTML 不一定讓內容更正確，但它會讓內容更容易被人看見、理解和檢查。
HTML 不只能看，還可以用來操作
不過，Thariq 這篇文章最有意思的地方，不只是說 HTML 更好讀。
真正讓人眼睛一亮的是：HTML 可以變成一個臨時小工具。
也就是說，Claude Code 不只是生成一個頁面給你看。它還可以生成一個介面，讓你在裡面操作、調整、選擇，然後把結果再回傳給 Claude Code。
比如你要重新排 30 個 Linear tickets 的優先順序。如果只在聊天框裡做這件事，會很彆扭。你要一條條說：這個放前面，那個往後挪，這幾個先不做。
更自然的方式是，讓 Claude Code 直接生成一個 HTML 看板。頁面裡有 Now、Next、Later、Cut 四欄，每個 ticket 是一張可以拖動的卡片。Claude 先排一版，你再拖曳調整，最後一鍵匯出 Markdown。
再比如調 system prompt。Claude 可以生成一個 HTML 頁面，左邊是可編輯的 prompt，右邊放範例輸入和即時預覽，底部再放 token 計數和複製按鈕。
這個變化很重要。HTML 把 Claude 的輸出從「等你閱讀的文件」，變成了「可以操作的介面」。
人在做判斷時，經常不是線性閱讀，而是在比較、移動、篩選、調整、反覆看效果。HTML 把這部分動作接住了。
寫在最後：Markdown 適合輕量文本，HTML 更適合複雜計劃
當然，Thariq 並沒有把 HTML 說成完美方案。
HTML 通常比 Markdown 更耗 token，也更慢。他提到，生成 HTML 可能比 Markdown 慢 2 到 4 倍。版本控制也是問題，Markdown 的 diff 很清楚，HTML diff 往往更吵雜。
所以這篇文章不是在說 Markdown 已經過時，也不是說所有 AI 輸出都應該變成 HTML。
更準確地說，Markdown 適合輕量文本、README、簡單說明、長期維護的文件。HTML 更適合複雜計劃、程式碼解釋、視覺化報告、方案比較、互動偵錯和一次性決策介面。
這不是格式之爭，而是場景選擇。
而在文章最後，Thariq 最後講到一個很關鍵的感受：他喜歡用 HTML，不只是因為它表達力更強，而是因為它讓自己更 stay in the loop。
翻成更直白的中文，就是：人沒有被 AI 的工作過程甩出去。
Claude Code 生成一份幾百行的 Markdown plan，你掃一眼，覺得差不多，就讓它繼續。表面上看，是 AI 更自動化了；實際上，人可能也更容易失去判斷感。
HTML 帶來的變化，是把人重新拉回來。它讓計劃更容易讀，讓方案更容易比較，讓程式碼變化更容易審查，讓參數更容易調整，讓結果更容易回傳給 Claude。
所以 HTML 的價值，不是讓 Claude 更獨立，而是讓人更容易介入。
這可能就是 Thariq 說 HTML 「unreasonably effective」的原因：它看起來只是換了個格式，但真正改變的是人和 Claude Code 協作的感覺。
原文連結：https://x.com/trq212/status/2052809885763747935
一起「點讚」三連↓