# 策展 · X (Twitter) 🔥🔥🔥

> 作者：花叔 (@AlchainHust) · 平台：X (Twitter) · 日期：2026-05-10

> 原始來源：https://x.com/AlchainHust/status/2053138568818684101

## 中文摘要

# Markdown 還是 HTML？這是個蠢問題！

昨天，Claude Code 團隊的 Thariq 發了篇爆文，標題叫：HTML 是新的 markdown。他說他幾乎不再寫 markdown 文件了，轉而讓 Claude Code 給他生成 HTML。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1778375563319-iaHH42AsIWgAI7Zdyjpg.jpg)

這篇長文在 X 上夠火的，不到 24 小時就 500 萬+ 閱讀了，X 上很多人立刻分成了兩派。一派是 markdown 黨，覺得 md 格式才是 AI 時代的原始碼；另一派覺得 Thariq 好像發現了一個了不起的真相，HTML 樣式確實強多了。

國內我看也有不少科技媒體做了轉發和解讀。

但……我看完想說……真特麼有什麼可吵的，你們根本是在爭一個蠢問題。

或者說，markdown or html，that is not a question。

在 Claude Code 團隊發文的前一天，其實我還在 X 上給 md 格式佔了個隊。我覺得自然語言才是這個時代真正重要的程式語言，md 就是這個時代最好的程式開發文件。CLAUDE.md、AGENTS.md 滿天飛，Karpathy 的 llm-wiki 架構也是三層 md，連我自己寫橙皮書每一章都是先擼 md 再編譯。怎麼看，md 都像是 AI 時代的原始碼。

但還有個現象是，其實我的 Huashu Design 完全是在用 HTML 實現各種原型設計和資訊呈現，所以，我特麼難道又是 HTML 派？

想想我自己最近這週讓 AI 給我做的東西：產品原型、對比工具、解釋器、視覺化頁面，清一色全是 HTML。Huashu Design 這個 skill 更直接，專門用來批量生成 HTML 原型。我分享給朋友看的東西，幾乎一個 md 都沒有。

這麼一看，我又像個徹頭徹尾的 HTML 黨。

其實，這壓根就沒什麼好爭論的。

## md 黨和 html 黨

我們可以先來看看這一波的爭論，兩邊都在討論什麼。

先說 md 黨。

去年 8 月，OpenAI 發了個東西叫 AGENTS.md，就一個 md 文件寫在專案根目錄，告訴 AI Agent 怎麼幹活。一年時間被 60000 多個開源專案採用，Cursor、Codex、Devin、Claude Code、Gemini CLI、GitHub Copilot 都支援。去年 12 月 Linux Foundation 直接成立 Agentic AI Foundation 把它捐進去做開放標準，白金成員裡有 AWS、Anthropic、Google、Microsoft、OpenAI，基本是 AI 半壁江山一起坐下來給 md 站台。

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

Cloudflare 的實測數據：同一篇部落格，HTML 16180 個 token，轉成 md 只要 3150 個。一篇博文壓 80% 的 token，意味著同樣的 LLM 預算可以處理 7-17 倍的請求。

GitHub 官方部落格今年放出了一個有趣的說法：「文件不再是描述程式碼，文件就是程式碼。自然語言被編譯成下層語言，恰好長得像 Python 或者 JavaScript。」

我自己也觀察到一個挺諷刺的事。我那兩個開源專案，nuwa-skill 和 huashu-design，都是 1 萬+ star 的 repo，主體內容都是 md 文件。但因為裡面還有零散的 Python 和 HTML 文件，被 GitHub 貼了 Python 和 HTML 的語言標籤。GitHub 的專案分類系統，到現在還認不出 md 才是原始碼。md 在 GitHub 的語言標籤裡，連個名字都沒有。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1778375563237-iaHH42K1qWcAUARQcjpg.jpg)

這幾個方向的事實，我覺得完全可以得出「md 才是這個時代的原始碼」的結論。

但 html 黨也有理。

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

第一是空間資訊。diff、呼叫圖、架構圖、流程圖，本來就是有空間維度的資訊，md 把它們壓扁成一行行的字。同一份 diff，讓 AI 渲染成左右對照的 html 頁面，理解效率根本不是一個量級。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1778375563243-iaHH42ONrXAAIjwxKjpg.jpg)

第二是動態體驗。我做產品原型時讓 AI 生成帶動畫的 mock，按鈕按下去轉什麼顏色、用什麼 easing 曲線、過渡多久，這種東西文字描述再多都沒用，得真看一眼才能判斷。

第三是結構化閱讀。一篇帶可摺疊章節、tab 程式碼區塊、邊欄術語表的解釋器，跟「同樣的字線性堆一遍」根本是兩種東西。Thariq 原話：Each one trades a document you'd skim for one you'd actually read。原來你只會掃一眼的文件，現在你真的會讀。

Anthropic 今年 4 月推了 Live Artifacts，HTML 已經從靜態產物升級成「持久化、可互動、能拉即時資料的 dashboard」。

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

這些證據也挺硬的。html 黨贏了，如果他們的論點是「html 才是這個時代給人看的產物」的話。

但你看出問題了嗎。兩邊都贏了，因為他們各自在回答不同的問題。

md 黨回答的是「我們用什麼寫」，html 黨回答的是「我們給人什麼看」。這倆根本不是一個問題，怎麼會有誰取代誰。

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

## 真問題：md 生產，html 消費

我覺得是時候把真問題說出來了。

md 和 html 不是替代關係，是分工關係。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1778375563170-iaHH42RygW8AY4SWQjpg.jpg)

以前 md 和 html 也有過論戰。那時候 html 是預設（blog、文件、官網都是 html），後來 md 興起，因為它寫起來快、看起來乾淨。技術圈基本切到了 md。

那個論戰的隱含前提是：生產者和消費者是同一個人。你寫一份文件自己看或者寫給同事看，不管哪種，寫的人和讀的人都是人，是同一類使用者。所以選格式要折中，既要好寫，又要好看。md 勝出，因為它的折中點最舒服。

AI 出現後，第一次出現了一個新情況：生產成本可以被 AI 吸收。

你不再需要「親手編輯」產物。HTML 因為太重而被嫌棄的那部分代價，由 AI 承擔了。你只承擔消費。

這意味著原來要折中的需求，被解耦成了兩端的極端最優。

生產端要的是輕、是快、是可 diff、是 token-efficient。那就是 md。 消費端要的是豐富、是視覺化、是可互動、是好分享。那就是 html。

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

最乾淨的活體證據其實是 Thariq 自己。同一個工程師，3 月份發了篇 Skills 使用指南，裡面強調「skill 不只是 markdown 文件，但核心還是 markdown」，他在生產端力推 md。5 月份發了那篇《HTML 的不合理有效性》，他在消費端力推 html。同一個人，兩端各自登頂，互不打架。Thariq 自己就是這個分工的活樣本。

第二個例子是 Karpathy 和 Lex Fridman 那對組合。Karpathy 的 llm-wiki 核心是 markdown wiki，所有原始資料、概念頁、索引都是 md。Lex Fridman 用了同款架構，在外面加了一層，讓 AI 生成動態 html+JavaScript，可以排序、過濾、調參、做互動視覺化。核心 md，外殼 html。不是 Lex 替換了 Karpathy，是他在 Karpathy 的基礎上加了一層消費層。兩層各做各的事，不衝突，互相加強。

所以 Thariq 沒錯，md 黨也沒錯，他們都對了一半。但只要還在「md vs html」這個二元對立的框子裡，就永遠只能拿到一半的真相。但，其實沒有任何人比你當二極管的。

以前你寫 md 看 md。現在你寫 md，改 md，AI 給你 html。

## 但爭論為什麼停不下來

我自己其實早就在用這個分工幹活，只是沒意識到這是一個值得命名的事情。直到看 Thariq 那篇文章那一刻，才反應過來。

但我也理解為什麼大部分人還卡在二元對立裡。

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

當你既是內容的生產者，又是內容的消費者，既創作內容，又創作產品的時候。你會意識到那些亂七八糟的站隊就是扯淡。

你會越來越清楚的知道你應該什麼時候用 md，什麼時候用 HTML，一切都是為了創作和表達服務的，而不是為了一個虛無縹緲的立場。

## 我的解法：huashu-md-html

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

GitHub 開源位址（MIT License）

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

它幹一件事：讓你隨時在 md 和 html 之間切換，不需要站隊。

具體三個能力。

能力一：把任意東西變成 md。封裝微軟的 markitdown，PDF、DOCX、PPTX、XLSX、EPub、圖片、音訊、YouTube URL、ZIP 壓縮包、網頁，20 多種格式都能轉成乾淨的 md。一行命令搞定：python any_to_md.py file.pdf。

能力二：把 md 變成精美的 html。封裝 Pandoc 加 4 套手工調過的 CSS 主題。article 是 Tufte 編輯型，適合 essay 和深度文章；report 是出版級白皮書風，適合技術報告；reading 是 Medium 極簡型，適合純閱讀分發；interactive 是帶側邊欄目錄的長文型，適合教程和書籍章節。每套主題都過了反 AI slop 檢查清單，沒有紫漸變、沒有 emoji 當圖示、沒有 #0D1117 深藍底，配色克制有出版社品位。

能力三：把 html 轉回 md。雙引擎。部落格文章和新聞類頁面走 trafilatura 自動提取正文，去掉導航和側欄；產品頁和技術文件走 markitdown，保留完整的 metadata、標題層級和連結。一條命令搞定。

三個能力組成一個完整閉環：輸入端永遠是 md，輸出端按場景選 html 主題。md 是源，html 是產物，這是一個工作流問題，不是站隊問題。

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

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1778375563182-iaHH42lvyXYAQ1bVWjpg.jpg)

橙皮書 7 本，全部免費上架微信讀書，加起來讀者過百萬。經常有人問我同一個問題：你的橙皮書排版怎麼這麼好看？比一般電子書強太多了。

答案就是這個分工。每本書寫作時我讓 AI 產出的從來都是 md。一章一章的 md 文件，簡單的標題層級，行內程式碼區塊，普通的無序列表。我 review 改的也是 md。到了構建環節有一個 build 腳本，md 轉成 html 章節片段，html 再編譯成 epub 和 pdf。所有的字體選擇、顏色搭配、版面設計、章節裝飾、程式碼高亮，全在 html 那一層做。

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

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

## 別再爭了

回到開頭。

Thariq 沒錯，md 黨也沒錯。但他們在爭的那個問題，「哪個會贏」，是個偽命題。

md 不會贏，html 也不會贏。它們在不同的端各自登頂，互不替代，互相增強。

你下次想吵這個的時候，先問自己一句——

你現在面對的是「寫」，還是「看」？

寫，用 md。

看，用 html。

工具替你處理切換，立場可以放下了。

附：huashu-md-html 開源位址 https://github.com/alchaincyf/huashu-md-html · MIT License · 三個能力 · 4 套主題 · 反 AI slop 審美底線 · 與 huashu-design 同生態。

## 標籤

Claude Code, CLI, 其他, Anthropic, Claude