當 AI 開始交付複雜工作，HTML 可能才是更合理的輸出格式
整理版優先睇
HTML 比 Markdown 更適合 AI 交付複雜工作，專注人類審閲效率
呢篇文章引述 Anthropic 工程師 Thariq Shihipar 嘅觀察：佢已經好少叫 Claude Code 出 Markdown，而係直接叫佢生成 HTML 檔案。作者係程序員時宇，佢認為呢個趨勢反映咗一個本質問題——AI 嘅輸出已經由「幾段文字」變成「可交付材料」，Markdown 嘅簡單反而變成限制。
Markdown 好適合快速記錄，但當 AI 一次過審查成個 Pull Request、設計架構或者產出決策報告時，人類需要嘅係高密度、可掃讀嘅視覺組織。HTML 可以透過顏色、分區、表格、互動元件去表達風險層級，令人一眼睇到邊度最危險，唔需要喺終端機滾來滾去。
整體結論係：Token 成本持續下降，人類注意力成本持續上升。與其慳 Token 而犧牲閲讀效率，不如用多啲 Token 轉做 HTML，令審閲時間由 20 分鐘縮到 3 分鐘。呢個轉變唔係要消滅 Markdown，而係要認清兩者嘅定位——Markdown 適合思考，HTML 適合行動。
- 結論：AI 輸出複雜工作時，HTML 嘅信息密度同可視化能力遠超 Markdown，更能幫助人類快速判斷。
- 方法：要求 AI 直接生成包含顏色、分區、表格、互動嘅 HTML，而非純文字報告。
- 差異：Markdown 適合思考（低摩擦記錄），HTML 適合行動（審閲、決策、分享）。
- 啟發：人類角色由生產者轉為審閲者，輸出格式應優先服務「點樣睇」而非「點樣寫」。
- 可行動點：下次叫 AI 做 PR 審查、方案對比等複雜任務時，試下要求佢輸出 HTML 格式。
Thariq Shihipar HTML Effectiveness 案例站點
包含多個 HTML 輸出示例，展示 PR 審查、方案對比、互動沙箱等實際應用。
Markdown 嘅信息密度已經唔夠用
我哋鍾意 Markdown，因為佢簡單。但簡單嘅代價係表達能力有限。你一定見過呢種 AI 輸出：一整屏密密麻麻嘅項目符號、代碼塊、解釋段落、風險說明，喺終端裏面來回滾動，好難記住前面講咗啲乜。
信息密度
呢個唔係閲讀能力嘅問題，而係格式嘅問題。AI 能力越強，輸出越複雜；輸出越複雜，越需要層次、顏色、對比、交互同視覺組織。Markdown 能表達結構，但好難承載高密度嘅信息判斷。
HTML 嘅四大優勢：密度、視覺、互動、分享
Thariq 嘅核心觀點係：當 AI 成為主要生產者，人類主要負責審閲、判斷同反饋，輸出格式應該優先服務「人類點樣消費資訊」。HTML 喺呢件事上有四個優勢。
- 1 信息密度更高：HTML 可以有表格、卡片、顏色、代碼 diff、SVG 圖形、佈局分區，複雜資訊可以拆成多個視覺層級。
- 2 視覺判斷更快：一份報告入面，阻塞問題用紅色，建議項用黃色，安全部分用綠色。文件按風險排序，睇一眼就知邊度最危險。
- 3 可以交互：AI 可以生成一個小工具，例如左邊編輯模板右邊實時預覽樣例嘅 Prompt 調優器，或者拖動滑塊調整動畫曲線嘅沙箱。
- 4 分享更直接：HTML 檔案雙擊就開到，發俾同事唔使解釋用咩渲染器。Markdown 喺非技術環境打開好多時係源碼。
Token 成本下降，人類注意力成本上升
當然 HTML 會消耗更多 Token，通常比 Markdown 貴。但呢筆賬要咁睇：如果多花啲 Token 可以令一個人由 20 分鐘滾動閲讀變成 3 分鐘睇懂重點，咁就好值得。
九類場景：由 PR 審查到互動沙箱
Thariq 展示咗好多真實案例，可以歸納成九類場景。呢啲場景有一個共通點：佢哋唔係為咗「寫低」，而係為咗「令人快速判斷並採取行動」。
- PR 審查：用顏色、分區同行級註釋，令風險快速暴露。
- 架構設計：將模塊、依賴、數據流、失敗路徑畫出嚟。
- 方案對比：三種方案並排，每種列出成本、風險、適用條件同推薦結論。
- 概念教學：例如一致性哈希，用一個可交互嘅哈希環比幾千字解釋更易明。
- Prompt 調優：左邊寫模板，右邊實時預覽多組樣例。
- 路線圖同工單排序：拖拽看板比純文字優先級列表更直觀。
- 數據報告：圖表、表格、異常標註，適合決策。
- 互動式沙箱：參數調試、動畫調試、配置預覽，變成一個小頁面。
呢啲場景唔係為咗「寫低」，而係為咗「令人快速判斷」
選擇標準：思考用 Markdown，行動用 HTML
呢篇文唔係想話「Markdown 已死」。Markdown 仍然好適合快速記錄、簡單說明、輕量溝通、README、筆記同短答案。佢嘅優勢係低成本、低摩擦、易編輯。
輸出主要用於繼續思考，Markdown 就夠
但係我哋要承認：唔係所有 AI 輸出都應該默認係 Markdown。一個簡單嘅判斷標準：如果輸出主要用於繼續思考，Markdown 好好；如果主要用於審閲、決策、演示、交互同分享，HTML 往往更好。用一句講就係：Markdown 適合思考，HTML 適合行動。
人類角色轉變：由寫變成睇
過去程序員係生產者，寫代碼、寫文檔、寫說明，自然需要輕量順手嘅格式，Markdown 啱啱好。但喺 Agent 時代，AI 越來越多承擔生產工作，人類核心任務變咗做審閲、判斷、約束、反饋同決策。
角色變咗，工具標準都要變
當人類由「寫嘅人」變成「睇嘅人」，格式嘅第一優先級就唔再係「好唔好寫」，而係「好唔好讀、好唔好檢查、好唔好反饋」。呢個正係 HTML 重新變得重要嘅原因。
輸出格式本身就係工作流嘅一部分
Thariq 呢篇文之所以引起爭議，就係因為佢點醒咗一個好多人忽略嘅事實：AI 時代，輸出格式本身就係工作流嘅一部分。如果你只係問一個小問題，Markdown 夠用；但如果你叫 AI 審查複雜 PR、比較架構方案、解釋複雜系統、生成可交付報告，不妨試下直接要求佢輸出 HTML。
㩒上面🔺公眾號🔺關注我✅覺得好嘅話，可以星標埋。
將代碼寫成藝術，用 AI 嚟做鍵盤。
大家好呀，我係程序員時宇——一個將 AI 當鍵盤用嘅編程玩家。呢度淨係講三樣嘢：技巧、踩坑、前沿資訊。想一齊將代碼寫成詩？㩒個關注，我哋並肩開掛，一齊將代碼寫成帶薪摸魚嘅藝術。
呢兩日，有一條推文喺技術圈爆咗。
Anthropic 工程師 Thariq Shihipar 喺 X 出咗篇長文，標題好直接：HTML 好用得離譜。佢話，自己已經差唔多停咗叫 Claude Code 輸出 Markdown，反而叫佢直接生成 HTML 檔案。
聽落好反直覺。
Markdown 幾好用啊。簡單、輕量、周圍都渲染到。寫文檔、記筆記、貼代碼，幾乎係程序員嘅默認格式。
但我認真睇完佢俾嘅案例之後，諗法變咗。
問題唔係 Markdown 唔好，而係 AI 嘅輸出經已變咗。以前我哋叫 AI 寫兩段代碼、解釋一個報錯、列一個清單，Markdown 夠用。但而家，AI 一次可以審查一個 Pull Request，可以設計一套架構，可以解釋一個複雜系統，可以出一個需要團隊決策嘅報告。
當輸出由「幾段文字」變成「可交付材料」嘅時候，Markdown 嘅簡單反而會變成限制。
Markdown 嘅問題：資訊密度唔夠了
我哋鍾意 Markdown，係因為佢簡單。
但佢嘅簡單，亦都表示表達能力有限。
你一定見過呢種 AI 輸出：成個螢幕密密麻麻嘅項目符號、代碼塊、解釋段落、風險說明。你喺終端機裏面來回碌，想記低頭先講咗啲乜，再對照後面嘅判斷。
呢個唔係閲讀能力嘅問題，而係格式嘅問題。
AI 嘅能力越強，輸出越複雜；輸出越複雜，就越需要層次、顏色、對比、互動同視覺組織。Markdown 表達到結構，但好難承載高密度嘅資訊判斷。
特別係代碼審查、架構評估、方案對比呢類場景，真正有價值嘅唔係「將資訊寫出嚟」，而係令人快啲捉到重點。
點解 HTML 更啱 Agent 時代
Thariq 嘅核心觀點好簡單：當 AI 成為主要生產者，人類更加多負責審閲、判斷同反饋嘅時候，輸出格式應該優先服務於「人類點樣消費資訊」。
HTML 喺呢件事上有四個優勢。
第一，資訊密度更高。
HTML 唔單止係帶格式嘅文字。佢可以有表格、卡片、顏色、代碼 diff、SVG 圖形、佈局分區。複雜資訊可以拆成多個視覺層級，而唔係全部塞入一面文字牆。
第二，視覺判斷更快。
比如一份代碼審查報告，阻塞問題用紅色，建議項用黃色，安全部分用綠色。檔案按風險排序，每段 diff 旁邊直接放行級註釋。你唔使逐字睇完，先掃一眼就知邊度最危險。
第三，可以互動。
呢點最關鍵。
AI 唔單止可以生成一份「報告」，仲可以生成一個小工具。例如 Prompt 調優器，左邊編輯模板，右邊實時預覽樣例；例如動畫參數沙箱，拉動滑塊調整曲線，然後一鍵複製 JSON；例如工單優先級看板，拖拽調整後複製成 Markdown 結果。
呢個時候 HTML 唔再係裝飾，而係你同 AI 協作嘅調試界面。
第四，分享更直接。
HTML 檔案可以自包含。雙擊就開到，Send 畀同事都唔使解釋用咩渲染器。相比之下，Markdown 喺好多非技術環境下打開就係源碼。
當然，HTML 都唔係冇成本。佢會消耗多啲 Token，通常比 Markdown 貴啲。
但呢度有一個現實判斷：Token 成本喺度下降，人類注意力成本喺度上升。如果花多少少 Token，可以令一個人由 20 分鐘嘅碌屏閲讀變成 3 分鐘睇明重點，呢條數好可能係抵嘅。
一個最典型嘅場景：代碼審查
假設你叫 AI 審查一個 PR，涉及 6 個檔案、上百行改動。
如果輸出係 Markdown，你大概率會見到：
一段概述。
一堆問題列表。
幾個代碼塊。
一啲建議。
然後你開始喺終端機裏面上下碌，嘗試將檔案、風險、代碼位置同修復建議喺個腦度砌返埋。
如果輸出係 HTML，體驗會完全唔同。
你可以叫 AI 生成一個可視化審查頁：左邊係檔案列表，中間係 diff，右邊係評論；嚴重問題紅色標註，次要問題黃色標註，通過項綠色標註；頂部直接畀出阻塞項數量同風險摘要。
呢個時候你唔係「讀完一篇報告」，而係「檢查一個儀錶板」。
對工程負責人嚟講，呢個差異好大。因為審查複雜資訊嘅時候，最難嘅唔係獲取資訊，而係避免遺漏關鍵資訊。
唔止係代碼：HTML 嘅九類高價值場景
Thariq 展示咗好多真實案例，我將佢哋歸納成九類。
第一類係 PR 審查。用顏色、分區同行級註釋，令風險快速暴露。
第二類係架構設計。將模塊、依賴、數據流、失敗路徑畫出嚟，而唔係淨係寫一串段落。
第三類係方案對比。三種方案並排展示，每種方案列出成本、風險、適用條件同推薦結論。
第四類係概念教學。例如一致性哈希，用一個可以互動嘅哈希環，比起幾千字解釋更加易明。
第五類係 Prompt 調優。左邊寫模板，右邊實時預覽多組樣例，改完直接複製。
第六類係路線圖同工單排序。拖拽看板比純文字優先級列表更直觀。
第七類係數據報告。圖表、表格、異常標註，比起長篇分析更適合決策。
第八類係互動式沙箱。參數調試、動畫調試、配置預覽，都可以變成一個小頁面。
第九類係可分享簡報。畀團隊、客戶或非技術同事睇嘅時候，HTML 比起 Markdown 更慳解釋成本。
呢啲場景有一個共通點：佢哋唔係為咗「寫低」，而係為咗「令人快啲判斷並採取行動」。
Markdown 仍然未過時
呢篇唔係一篇「Markdown 已死」嘅文。
Markdown 仍然非常適合快速記錄、簡單說明、輕量溝通、README、筆記同短答案。佢嘅優勢係低成本、低摩擦、易編輯。
但我哋需要承認：唔係所有 AI 輸出都應該默認係 Markdown。
一個簡單判斷標準係：
如果輸出主要用於繼續思考，Markdown 好好。
如果輸出主要用於審閲、決策、演示、互動同分享，HTML 通常更好。
亦可以更短咁講：
Markdown 適合思考，HTML 適合行動。
真正嘅變化：人類角色變咗
呢件事背後，其實係開發工作方式嘅變化。
以前，程序員主要係生產者。我哋寫代碼、寫文檔、寫說明，所以我哋需要輕量、順手、可以快啲輸入嘅格式。Markdown 啱啱滿足呢個需求。
但喺 Agent 時代，AI 會越來越多咁承擔生產工作。人類嘅核心任務會更加多變成審閲、判斷、約束、反饋同決策。
角色變咗，工具標準都要變。
當人類由「寫嘅人」變成「睇嘅人」，格式嘅第一優先級就唔再係好唔好寫，而係好唔好讀、好唔好檢查、好唔好反饋。
呢個正係 HTML 重新變得重要嘅原因。
結語
Thariq 呢篇文章之所以引起爭議，唔係因為佢真係想消滅 Markdown，而係因為佢提醒咗一個好多人忽略咗嘅事實：
AI 時代，輸出格式本身就係工作流程嘅一部分。
如果你只係叫 AI 回答一個小問題，Markdown 夠用。
但如果你叫 AI 審查複雜 PR、比較架構方案、解釋複雜系統、生成可交付報告，不妨試嚇直接要求佢輸出 HTML。
你可能會發現，差別唔只係「好睇啲」。
佢會令資訊更容易被檢查，令風險更容易被發現，令反饋更容易發生。
呢個先係格式變化真正有價值嘅地方。
參考：Thariq Shihipar 關於 HTML effectiveness 嘅原始文章同案例站點：https://github.com/ThariqS/html-effectiveness.git
點擊上方🔺公眾號🔺關注我✅覺得不錯，可以星標。
把代碼寫成藝術，用 AI 當鍵盤。
大家好呀，我是程序員時宇——一個把 AI 當鍵盤用的編程玩家。這裏只聊三件事：技巧、踩坑、前沿資訊。想一起把代碼寫成詩？點個關注，我們並肩開掛，一起把代碼寫成帶薪摸魚的藝術。
這兩天，一條推文在技術圈炸開了鍋。
Anthropic 工程師 Thariq Shihipar 在 X 上發了一篇長文，標題很直接：HTML 好用得離譜。他說，自己已經幾乎停止讓 Claude Code 輸出 Markdown，轉而讓它直接生成 HTML 文件。
這聽起來很反直覺。
Markdown 多好用啊。簡單、輕量、到處都能渲染。寫文檔、記筆記、貼代碼，幾乎是程序員的默認格式。
但我認真讀完他給出的案例後，想法變了。
問題不是 Markdown 不好，而是 AI 的輸出已經變了。過去我們讓 AI 寫兩段代碼、解釋一個報錯、列一個清單，Markdown 足夠。但現在，AI 一次可以審查一個 Pull Request，可以設計一套架構，可以解釋一個複雜系統，可以產出一份需要團隊決策的報告。
當輸出從“幾段文字”變成“可交付材料”時，Markdown 的簡單反而會變成限制。
Markdown 的問題：信息密度不夠了
我們喜歡 Markdown，是因為它簡單。
但它的簡單，也意味着表達能力有限。
你一定見過這種 AI 輸出：一整屏密密麻麻的項目符號、代碼塊、解釋段落、風險說明。你在終端裏來回滾動，試圖記住前面說了什麼，再對照後面的判斷。
這不是閲讀能力的問題，而是格式的問題。
AI 的能力越強，輸出越複雜；輸出越複雜，越需要層次、顏色、對比、交互和視覺組織。Markdown 能表達結構，但很難承載高密度的信息判斷。
尤其是代碼審查、架構評估、方案對比這種場景，真正有價值的不是“把信息寫出來”，而是讓人快速抓住重點。
HTML 為什麼更適合 Agent 時代
Thariq 的核心觀點很簡單：當 AI 成為主要生產者，人類更多負責審閲、判斷和反饋時，輸出格式應該優先服務於“人類如何消費信息”。
HTML 在這件事上有四個優勢。
第一，信息密度更高。
HTML 不只是帶格式的文本。它可以有表格、卡片、顏色、代碼 diff、SVG 圖形、佈局分區。複雜信息可以被拆成多個視覺層級，而不是全部壓進一面文本牆。
第二，視覺判斷更快。
比如一份代碼審查報告，阻塞問題用紅色，建議項用黃色，安全部分用綠色。文件按風險排序，每段 diff 旁邊直接放行級註釋。你不用逐字讀完，先掃一眼就知道哪裏最危險。
第三，可以交互。
這點最關鍵。
AI 不只能生成一份“報告”，還可以生成一個小工具。比如 Prompt 調優器，左邊編輯模板，右邊實時預覽樣例；比如動畫參數沙箱，拖動滑塊調整曲線，然後一鍵複製 JSON；比如工單優先級看板，拖拽調整後複製成 Markdown 結果。
這時 HTML 不再是裝飾，而是你和 AI 協作的調試界面。
第四，分享更直接。
HTML 文件可以自包含。雙擊就能打開，發給同事也不需要解釋用什麼渲染器。相比之下，Markdown 在很多非技術環境裏打開就是源碼。
當然，HTML 也不是沒有成本。它會多消耗 Token，通常比 Markdown 貴一些。
但這裏有一個現實判斷：Token 成本在下降，人類注意力成本在上升。如果多花一點 Token，能讓一個人從 20 分鐘的滾動閲讀變成 3 分鐘看懂重點，這筆賬很可能是划算的。
一個最典型的場景：代碼審查
假設你讓 AI 審查一個 PR，涉及 6 個文件、上百行改動。
如果輸出是 Markdown，你大概率會看到：
一段概述。
一堆問題列表。
幾個代碼塊。
一些建議。
然後你開始在終端裏上下滾動，嘗試把文件、風險、代碼位置和修復建議在腦子裏拼起來。
如果輸出是 HTML，體驗會完全不同。
你可以讓 AI 生成一個可視化審查頁：左側是文件列表，中間是 diff，右側是評論；嚴重問題紅色標註，次要問題黃色標註，通過項綠色標註；頂部直接給出阻塞項數量和風險摘要。
這時你不是“讀完一篇報告”，而是在“檢查一個儀表盤”。
對工程負責人來說，這個差異很大。因為審查複雜信息時，最難的不是獲取信息，而是避免遺漏關鍵信息。
不只是代碼：HTML 的九類高價值場景
Thariq 展示了很多真實案例，我把它們歸納成九類。
第一類是 PR 審查。用顏色、分區和行級註釋，讓風險快速暴露。
第二類是架構設計。把模塊、依賴、數據流、失敗路徑畫出來，而不是隻寫一串段落。
第三類是方案對比。三種方案並排展示，每種方案列出成本、風險、適用條件和推薦結論。
第四類是概念教學。比如一致性哈希，用一個可交互的哈希環，比幾千字解釋更容易讓人理解。
第五類是 Prompt 調優。左側寫模板，右側實時預覽多組樣例，改完直接複製。
第六類是路線圖和工單排序。拖拽看板比純文本優先級列表更直觀。
第七類是數據報告。圖表、表格、異常標註，比長段分析更適合決策。
第八類是交互式沙箱。參數調試、動畫調試、配置預覽，都可以變成一個小頁面。
第九類是可分享簡報。給團隊、客戶或非技術同事看時，HTML 比 Markdown 更省解釋成本。
這些場景有一個共同點：它們不是為了“寫下來”，而是為了“讓人快速判斷並採取行動”。
Markdown 仍然沒有過時
這不是一篇“Markdown 已死”的文章。
Markdown 仍然非常適合快速記錄、簡單說明、輕量溝通、README、筆記和短答案。它的優勢是低成本、低摩擦、易編輯。
但我們需要承認：不是所有 AI 輸出都應該默認是 Markdown。
一個簡單判斷標準是：
如果輸出主要用於繼續思考，Markdown 很好。
如果輸出主要用於審閲、決策、演示、交互和分享，HTML 往往更好。
也可以更短地說：
Markdown 適合思考，HTML 適合行動。
真正的變化：人類角色變了
這件事背後，其實是開發工作方式的變化。
過去，程序員主要是生產者。我們寫代碼、寫文檔、寫說明，所以我們需要輕量、順手、能快速輸入的格式。Markdown 正好滿足這個需求。
但在 Agent 時代，AI 會越來越多地承擔生產工作。人類的核心任務會更多變成審閲、判斷、約束、反饋和決策。
角色變了，工具標準也要變。
當人類從“寫的人”變成“看的人”，格式的第一優先級就不再是好不好寫，而是好不好讀、好不好檢查、好不好反饋。
這正是 HTML 重新變得重要的原因。
結語
Thariq 這篇文章之所以引發爭議，不是因為它真的要消滅 Markdown，而是因為它提醒了一個被很多人忽略的事實：
AI 時代，輸出格式本身就是工作流的一部分。
如果你只是讓 AI 回答一個小問題，Markdown 足夠。
但如果你讓 AI 審查複雜 PR、比較架構方案、解釋複雜系統、生成可交付報告，不妨試試直接要求它輸出 HTML。
你可能會發現，差別不只是“好看一點”。
它會讓信息更容易被檢查，讓風險更容易被發現，讓反饋更容易發生。
這才是格式變化真正有價值的地方。
參考：Thariq Shihipar 關於 HTML effectiveness 的原始文章與案例站點：https://github.com/ThariqS/html-effectiveness.git