Markdown vs HTML:AI 時代的生產與消費解耦 (The Markdown vs HTML Debate is a Stupid Question)
原始來源與檔名:20260512_2026-05-12T093130+0800-Markdown还是HTML?这是个蠢问题!.md
來源:[[@AlchainHust]] / X (Twitter) — 2026-05-09
原始檔名:2026-05-12T093130+0800-Markdown还是HTML?这是个蠢问题!.md
NAPKIN | 餐巾紙
餐巾紙公式
Pre-AI Era: Producer = Consumer -> Format compromise (Markdown won because it balances writing speed & readability) AI Era: AI absorbs production cost -> Format decoupling Production = Markdown (Fast, token-efficient, diffable source code) Consumption = HTML (Rich, interactive, dynamic UI)
網路上正在爭吵 AI 時代的標準格式是 Markdown 還是 HTML。這是一個蠢問題,因為它們解決的是不同的需求。在 AI 吸納了「排版與渲染」的生產成本後,我們不再需要尋找「既好寫又好看」的折衷方案。生產端徹底倒向 Markdown(省 Token、好比對、純邏輯);消費端徹底倒向 HTML(豐富的視覺、互動與空間結構)。這不是誰取代誰,而是完美的分工。
一句話
針對 Claude Code 團隊引發的「HTML 是新的 Markdown」論戰,作者提出了極具洞見的解構:這是一場源於「視角單一」的偽命題。當人們同時身為生產者與消費者時,才需要折衷。在 AI 時代,人類用 Markdown 提供純粹的邏輯與文本上下文給 AI,由 AI 承擔繁重的 HTML 開發成本,最終產出具備強大空間與互動表現力的 HTML 供人類消費。作者並開源了
huashu-md-html工具來實踐這種無縫切換的工作流。
餐巾紙草圖
[The Decoupling of Formats in the AI Era]
[ Production Phase ] (Focus: Logic, Speed, Token-efficiency)
Human writes `.md` ---> AI consumes `.md` (10x cheaper in context)
|
v
[ AI Transformation Engine ] (AI absorbs the formatting labor)
|
v
[ Consumption Phase ] (Focus: Spatial understanding, Interactivity)
AI outputs `.html` ---> Human views dynamic dashboards / interactive pages.
ROUND 1: SKELETON | 骨架掃描
“這篇文章在說什麼”
- 起因: Claude Code 團隊的 Thariq 發表爆文《HTML 是新的 Markdown》,引發兩派爭論。
- Markdown 黨的理據: Markdown 是 AI 時代的源代碼。
AGENTS.md成為行業標準;Karpathy 的llm-wiki核心是.md;Markdown 比 HTML 節省 80% 的 Token,能大幅提升 LLM 的上下文利用率。 - HTML 黨的理據: HTML 能提供空間訊息(如左右對照的 diff)、動態體驗(按鈕動畫)、結構化閱讀(可摺疊章節)。它讓人類在與 AI 協作時更有「在場感」。
- 破局點 (The Real Question): 兩邊都對了一半。爭論的根源在於假設「生產者與消費者是同一個人」。
- AI 帶來的範式轉移: AI 吸納了生產 HTML 的繁重成本。我們不再需要折衷。寫的時候用 Markdown(追求極致輕量);看的時候用 HTML(追求極致表現力)。
- 工具實踐: 作者開發了
huashu-md-html,一個能將 20 多種格式轉為 Markdown,並能將 Markdown 渲染為 4 套專業 CSS 主題 HTML 的閉環工具。
ROUND 2: DISSECTION | 血肉解剖
“憑什麼這麼說”
核心論證鏈
- 歷史上的格式折衷: 在沒有 AI 以前,手寫 HTML 太痛苦,純文字又太醜,所以 Markdown 勝出,因為它是最好的「折衷」。
- 生產成本被 AI 抹平: 當 AI 可以瞬間將 Markdown 轉化為帶有 Tailwind 或自訂 CSS 的漂亮 HTML 時,手寫 HTML 的「痛苦」消失了。這意味著我們可以在生產端(輸入給 AI)極致追求 Token 效率,在消費端(人類閱讀)極致追求視覺表現。
- 活體證據 (Living Proof): 作者點出 Thariq 本人就是最好的例子。他一邊推廣用 Markdown 寫 Skill,一邊推廣用 HTML 看輸出結果。Karpathy 的
llm-wiki(底層 MD) 加上 Lex Fridman 的互動外殼 (表層 HTML) 也是同一個邏輯。這證明了「分工」早已在頂尖開發者的日常中發生。
關鍵證據
- Cloudflare 的實測數據:同一篇部落格,HTML 需要 16180 tokens,轉成 Markdown 只要 3150 tokens。在 Context Window 依然昂貴的今天,這 5 倍的差距就是巨大的成本與效能優勢。
邊界條件
- 這種工作流高度依賴「渲染引擎的可靠性」。如果 AI 在將 Markdown 轉為 HTML 時經常產生樣式崩潰(AI slop),那麼這種分工就會帶來巨大的修改成本。作者透過預設的 4 套手工 CSS 主題(而非讓 AI 自由發揮)來鎖死下限,解決了這個問題。
ROUND 3: SOUL | 靈魂提取
“還能怎么用”
- 知識連結: 呼應了《Contextmaxxing > Tokenmaxxing》中對 Token 效率的追求。用 Markdown 餵給 AI,就是一種 Contextmaxxing(用最少的 Token 傳遞最大的資訊密度)。同時也呼應了《Your Obsidian Vault Can Now Write Back to Itself》:底層知識庫必須是
.md,但產出的 Dashbaord 可以是富文本或網頁。 - 深層洞見: “两端各自登顶。中间那个折中位置,没人需要了。” (Both extremes reach the summit. The middle compromise is no longer needed.) 這是 AI 對所有軟體介面最深刻的衝擊。當 AI 可以作為完美的「編譯器」時,我們不再需要為了「易用性」而犧牲「專業度」,也不用為了「底層邏輯」而犧牲「視覺表現」。
- 行動呼籲:
停止在與 AI 的對話中爭論該輸出什麼格式。
- 當你需要 AI 讀取你的專案時,給它 Markdown。
- 當你需要 AI 展示資料關係、流程圖或 UI 原型時,直接命令它:“Generate an interactive HTML file using Tailwind CSS for me to preview.”