Markdown還是HTML？這是個(gè)蠢問題！

昨天，Claude Code團(tuán)隊(duì)的Thariq發(fā)了篇爆文，標(biāo)題叫：HTML是新的markdown。他說(shuō)他幾乎不再寫markdown文件了，轉(zhuǎn)而讓Claude Code給他生成HTML。

這篇長(zhǎng)文在X上夠火的，不到24小時(shí)就500萬(wàn)+閱讀了，X上很多人立刻分成了兩派。一派是markdown黨，覺得md格式才是AI時(shí)代的源代碼；另一派覺得Thariq好像發(fā)現(xiàn)了一個(gè)了不起的真相，HTML樣式確實(shí)強(qiáng)多了。

國(guó)內(nèi)我看也有不少科技媒體做了轉(zhuǎn)發(fā)和解讀。

但……我看完想說(shuō)……真特么有什么可吵的，你們根本是在爭(zhēng)一個(gè)蠢問題。

或者說(shuō)，markdown or html，that is not a question。

在Claude Code團(tuán)隊(duì)發(fā)文的前一天，其實(shí)我還在X上給md格式占了個(gè)隊(duì)。我覺得自然語(yǔ)言才是這個(gè)時(shí)代真正重要的編程語(yǔ)言，md就是這個(gè)時(shí)代最好的編程文件。CLAUDE.md、AGENTS.md滿天飛，Karpathy的llm-wiki架構(gòu)也是三層md，連我自己寫橙皮書每一章都是先擼md再編譯。怎么看，md都像是AI時(shí)代的源代碼。

但還有個(gè)現(xiàn)象是，其實(shí)我的Huashu Design完全是在用HTML實(shí)現(xiàn)各種原型設(shè)計(jì)和信息呈現(xiàn)，所以，我特么難道又是HTML派？

想想我自己最近這周讓AI給我做的東西：產(chǎn)品原型、對(duì)比工具、解釋器、可視化頁(yè)面，清一色全是HTML。Huashu Design這個(gè)skill更直接，專門用來(lái)批量生成HTML原型。我分享給朋友看的東西，幾乎一個(gè)md都沒有。

這么一看，我又像個(gè)徹頭徹尾的HTML黨。

其實(shí)，這壓根就沒什么好爭(zhēng)論的。

md黨和html黨

我們可以先來(lái)看看這一波的爭(zhēng)論，兩邊都在討論什么。

先說(shuō)md黨。

去年8月，OpenAI發(fā)了個(gè)東西叫AGENTS.md，就一個(gè)md文件寫在項(xiàng)目根目錄，告訴AI agent怎么干活。一年時(shí)間被60000多個(gè)開源項(xiàng)目采用，Cursor、Codex、Devin、Claude Code、Gemini CLI、GitHub Copilot都支持。去年12月Linux Foundation直接成立Agentic AI Foundation把它捐進(jìn)去做開放標(biāo)準(zhǔn)，白金成員里有AWS、Anthropic、Google、Microsoft、OpenAI，基本是AI半壁江山一起坐下來(lái)給md站臺(tái)。

Karpathy今年4月開源llm-wiki，核心架構(gòu)是三層md：raw目錄放原始資料，wiki目錄放AI寫的概念頁(yè)和索引，CLAUDE.md定義schema和規(guī)則。僅僅那個(gè)CLAUDE.md，單日就漲了7900個(gè)star，目前快5萬(wàn)了。一個(gè)markdown文件，5萬(wàn)star。

Cloudflare的實(shí)測(cè)數(shù)據(jù)：同一篇博客，HTML 16180個(gè)token，轉(zhuǎn)成md只要3150個(gè)。一篇博文壓80%的token，意味著同樣的LLM預(yù)算可以處理7-17倍的請(qǐng)求。

GitHub官方博客今年放出了一個(gè)有趣的說(shuō)法：「文檔不再是描述代碼，文檔就是代碼。自然語(yǔ)言被編譯成下層語(yǔ)言，恰好長(zhǎng)得像Python或者JavaScript。」

我自己也觀察到一個(gè)挺諷刺的事。我那兩個(gè)開源項(xiàng)目，nuwa-skill和huashu-design，都是1萬(wàn)+star的repo，主體內(nèi)容都是md文件。但因?yàn)槔锩孢€有零散的Python和HTML文件，被GitHub貼了Python和HTML的語(yǔ)言標(biāo)簽。GitHub的項(xiàng)目分類系統(tǒng)，到現(xiàn)在還認(rèn)不出md才是源代碼。md在GitHub的語(yǔ)言標(biāo)簽里，連個(gè)名字都沒有。

這幾個(gè)方向的事實(shí)，我覺得完全可以得出「md才是這個(gè)時(shí)代的源代碼」的結(jié)論。

但html黨也有理。

Thariq那篇爆文我讀完，他的幾條論據(jù)我都同意。

第一是空間信息。diff、調(diào)用圖、架構(gòu)圖、流程圖，本來(lái)就是有空間維度的信息，md把它們壓扁成一行行的字。同樣一份diff，讓AI渲染成左右對(duì)照的html頁(yè)面，理解效率根本不是一個(gè)量級(jí)。

第二是動(dòng)態(tài)體驗(yàn)。我做產(chǎn)品原型時(shí)讓AI生成帶動(dòng)畫的mock，按鈕按下去轉(zhuǎn)什么顏色、用什么easing曲線、過渡多久，這種東西文字描述再多都沒用，得真看一眼才能判斷。

第三是結(jié)構(gòu)化閱讀。一篇帶可折疊章節(jié)、tab代碼塊、邊欄術(shù)語(yǔ)表的解釋器，跟「同樣的字線性堆一遍」根本是兩種東西。Thariq原話：Each one trades a document you'd skim for one you'd actually read。原來(lái)你只會(huì)掃一眼的文檔，現(xiàn)在你真的會(huì)讀。

Anthropic今年4月推了Live Artifacts，HTML已經(jīng)從靜態(tài)產(chǎn)物升級(jí)成「持久化、可交互、能拉實(shí)時(shí)數(shù)據(jù)的dashboard」。

Thariq文章里有句話我記住了：the real reason I use HTML is that I feel much more in the loop with Claude。HTML讓他重新感覺自己在AI協(xié)作中「在場(chǎng)」。

這些證據(jù)也挺硬的。html黨贏了，如果他們的論點(diǎn)是「html才是這個(gè)時(shí)代給人看的產(chǎn)物」的話。

但你看出問題了嗎。兩邊都贏了，因?yàn)樗麄兏髯栽诨卮鸩煌膯栴}。

md黨回答的是「我們用什么寫」，html黨回答的是「我們給人什么看」。這倆根本不是一個(gè)問題，怎么會(huì)有誰(shuí)取代誰(shuí)。

是同一頭大象，他們摸到的是不同的部位。

真問題：md生產(chǎn)，html消費(fèi)

我覺得是時(shí)候把真問題說(shuō)出來(lái)了。

md和html不是替代關(guān)系，是分工關(guān)系。

以前md和html也有過論戰(zhàn)。那時(shí)候html是默認(rèn)（blog、文檔、官網(wǎng)都是html），后來(lái)md興起，因?yàn)樗鼘懫饋?lái)快、看起來(lái)干凈。技術(shù)圈基本切到了md。

那個(gè)論戰(zhàn)的隱含前提是：生產(chǎn)者和消費(fèi)者是同一個(gè)人。你寫一份文檔自己看或者寫給同事看，不管哪種，寫的人和讀的人都是人，是同一類用戶。所以選格式要折中，既要好寫，又要好看。md勝出，因?yàn)樗恼壑悬c(diǎn)最舒服。

AI出現(xiàn)后，第一次出現(xiàn)了一個(gè)新情況：生產(chǎn)成本可以被AI吸收。

你不再需要「親手編輯」產(chǎn)物。HTML因?yàn)樘囟幌訔壍哪遣糠执鷥r(jià)，由AI承擔(dān)了。你只承擔(dān)消費(fèi)。

這意味著原來(lái)要折中的需求，被解耦成了兩端的極端最優(yōu)。

生產(chǎn)端要的是輕、是快、是可diff、是token-efficient。那就是md。 消費(fèi)端要的是豐富、是可視化、是可交互、是好分享。那就是html。

兩端各自登頂。中間那個(gè)折中位置，沒人需要了。

最干凈的活體證據(jù)其實(shí)是Thariq自己。同一個(gè)工程師，3月份發(fā)了篇Skills使用指南，里面強(qiáng)調(diào)「skill不只是markdown文件，但核心還是markdown」，他在生產(chǎn)端力推md。5月份發(fā)了那篇《HTML的不合理有效性》，他在消費(fèi)端力推html。同一個(gè)人，兩端各自登頂，互不打架。Thariq自己就是這個(gè)分工的活樣本。

第二個(gè)例子是Karpathy和Lex Fridman那對(duì)組合。Karpathy的llm-wiki內(nèi)核是markdown wiki，所有原始資料、概念頁(yè)、索引都是md。Lex Fridman用了同款架構(gòu)，在外面加了一層，讓AI生成動(dòng)態(tài)html+JavaScript，可以排序、過濾、調(diào)參、做交互可視化。內(nèi)核md，外殼html。不是Lex替換了Karpathy，是他在Karpathy的基礎(chǔ)上加了一層消費(fèi)層。兩層各做各的事，不沖突，互相加強(qiáng)。

所以Thariq沒錯(cuò)，md黨也沒錯(cuò)，他們都對(duì)了一半。但只要還在「md vs html」這個(gè)二元對(duì)立的框子里，就永遠(yuǎn)只能拿到一半的真相。但，其實(shí)沒有任何人比你當(dāng)二極管的。

以前你寫md看md。現(xiàn)在你寫md，改md，AI給你html。

但爭(zhēng)論為什么停不下來(lái)

我自己其實(shí)早就在用這個(gè)分工干活，只是沒意識(shí)到這是一個(gè)值得命名的事情。直到看Thariq那篇文章那一刻，才反應(yīng)過來(lái)。

但我也理解為什么大部分人還卡在二元對(duì)立里。

我覺得大多數(shù)都是AI還用得不夠多，或者身份角色單一的。

當(dāng)你既是內(nèi)容的生產(chǎn)者，又是內(nèi)容的消費(fèi)者，既創(chuàng)作內(nèi)容，又創(chuàng)作產(chǎn)品的時(shí)候。你會(huì)意識(shí)到那些亂七八糟的站隊(duì)就是扯淡。

你會(huì)越來(lái)越清楚的知道你應(yīng)該什么時(shí)候用md，什么時(shí)候用HTML，一切都是為了創(chuàng)作和表達(dá)服務(wù)的，而不是為了一個(gè)虛無(wú)縹緲的立場(chǎng)。

我的解法：huashu-md-html

所以我做了個(gè)Claude Code skill，叫huashu-md-html。

GitHub開源地址（MIT License）：

https://github.com/alchain/huashu-md-html

它干一件事：讓你隨時(shí)在md和html之間切換，不需要站隊(duì)。

具體三個(gè)能力。

能力一：把任意東西變成md。封裝微軟的markitdown，PDF、DOCX、PPTX、XLSX、EPub、圖片、音頻、YouTube URL、ZIP壓縮包、網(wǎng)頁(yè)，20多種格式都能轉(zhuǎn)成干凈的md。一行命令搞定：python any_to_md.py file.pdf。

能力二：把md變成精美的html。封裝Pandoc加4套手工調(diào)過的CSS主題。article是Tufte編輯型，適合essay和深度文章；report是出版級(jí)白皮書風(fēng)，適合技術(shù)報(bào)告；reading是Medium極簡(jiǎn)型，適合純閱讀分發(fā)；interactive是帶側(cè)邊欄目錄的長(zhǎng)文型，適合教程和書籍章節(jié)。每套主題都過了反AI slop檢查清單，沒有紫漸變、沒有emoji當(dāng)圖標(biāo)、沒有，配色克制有出版社品位。

能力三：把html轉(zhuǎn)回md。雙引擎。博客文章和新聞?lì)愴?yè)面走trafilatura自動(dòng)提取正文，去掉導(dǎo)航和側(cè)欄；產(chǎn)品頁(yè)和技術(shù)文檔走markitdown，保留完整的metadata、標(biāo)題層級(jí)和鏈接。一條命令搞定。

三個(gè)能力組成一個(gè)完整閉環(huán)：輸入端永遠(yuǎn)是md，輸出端按場(chǎng)景選html主題。md是源，html是產(chǎn)物，這是一個(gè)工作流問題，不是站隊(duì)問題。

我自己最直接的活樣本是橙皮書系列。

橙皮書7本，全部免費(fèi)上架微信讀書，加起來(lái)讀者過百萬(wàn)。經(jīng)常有人問我同一個(gè)問題：你的橙皮書排版怎么這么好看？比一般電子書強(qiáng)太多了。

答案就是這個(gè)分工。每本書寫作時(shí)我讓AI產(chǎn)出的從來(lái)都是md。一章一章的md文件，簡(jiǎn)單的標(biāo)題層級(jí)，行內(nèi)代碼塊，普通的無(wú)序列表。我review改的也是md。到了構(gòu)建環(huán)節(jié)有一個(gè)build腳本，md轉(zhuǎn)成html章節(jié)片段，html再編譯成epub和pdf。所有的字體選擇、顏色搭配、版面設(shè)計(jì)、章節(jié)裝飾、代碼高亮，全在html那一層做。

讀者拿到的是漂亮的epub或pdf，html的所有表達(dá)力都用上了。但我和AI review的時(shí)候面對(duì)的永遠(yuǎn)是md，token efficient，能塞下整本書的上下文，沒有視覺干擾，能專心看文字。

我做這個(gè)skill其實(shí)就是把過去一年我自己干的事情工具化，讓任何人都能不站隊(duì)、不折騰、直接用對(duì)的格式干對(duì)的事。

別再爭(zhēng)了

回到開頭。

Thariq沒錯(cuò)，md黨也沒錯(cuò)。但他們?cè)跔?zhēng)的那個(gè)問題，「哪個(gè)會(huì)贏」，是個(gè)偽命題。

md不會(huì)贏，html也不會(huì)贏。它們?cè)诓煌亩烁髯缘琼敚ゲ惶娲ハ嘣鰪?qiáng)。

你下次想吵這個(gè)的時(shí)候，先問自己一句——

你現(xiàn)在面對(duì)的是「寫」，還是「看」？

寫，用md。

看，用html。

工具替你處理切換，立場(chǎng)可以放下了。

附：huashu-md-html開源地址 https://github.com/alchain/huashu-md-html

MIT License · 三個(gè)能力 · 4套主題 · 反AI slop審美底線 · 與huashu-design同生態(tài)。