Markdown還是HTML？這是個蠢問題！
整理版優先睇
Markdown與HTML並非對立，係生產同消費嘅分工關係
呢篇文章係由一位AI工具重度用家，針對Claude Code團隊Thariq嘅爆文《HTML係新嘅markdown》引起嘅爭論，整理出自己嘅觀察同反思。作者指出，X上嘅markdown黨同HTML黨各自有理，但其實爭論嘅根本係一個錯誤嘅二元對立。
作者拆解兩邊嘅論據：md黨強調token效率、開源標準同AI agent支援，認為md係AI時代嘅源代碼；HTML黨則強調空間信息、動態體驗同結構化閲讀，認為HTML先係俾人睇嘅產物。兩邊都啱，因為佢哋回答嘅係唔同問題—md回答「用咩寫」，HTML回答「俾人睇咩」。
作者結論係，md同HTML唔係替代關係，而係分工關係：生產端用md（輕量、高效、可diff），消費端用HTML（豐富、可視化、可交互）。AI出現之後，生產成本可以由AI吸收，唔使再折中。作者仲分享咗自己嘅工具huashu-md-html，可以隨時喺md同HTML之間切換，唔需要站隊。呢個分工模式已經喺佢嘅橙皮書系列得到驗證，讀者過百萬，排版獲好評。
- Markdown同HTML嘅爭論係假命題，佢哋係生產同消費嘅分工關係，唔係替代。
- 生產端應該用md：token高效、可diff、易於AI處理，係AI時代嘅源代碼。
- 消費端應該用HTML：提供空間信息、動態體驗同結構化閲讀，令人真係會讀。
- AI改變咗遊戲規則：生產成本由AI承擔，唔再需要折中，兩端可以各自登頂。
- 實戰方法：用huashu-md-html工具，將任何格式轉md，再按場景轉精美HTML，閉環工作流。
huashu-md-html GitHub開源地址
MIT License，三個能力（任意格式轉md、md轉精美HTML、HTML轉md），四套主題，反AI slop審美底線。
一場根本唔使吵嘅爭論
Claude Code團隊嘅Thariq發咗篇爆文，標題叫「HTML係新嘅markdown」，話自己幾乎唔再寫markdown，改為用Claude Code生成HTML。呢篇文章24小時內超過500萬閲讀，X上即刻分成兩派：markdown黨同HTML黨。
兩派各自有理，但其實爭論嘅係一個蠢問題
作者認為，呢個二元對立完全冇必要。佢自己前一日仲喺X上幫md佔隊，但實際工作上佢嘅Huashu Design完全用HTML實現原型。
作者自己都係md黨又係HTML黨，兩邊一齊用緊
md黨嘅理據：token效率同開放標準
去年8月OpenAI推出AGENTS.md，一年內被60000多個開源項目採用，Cursor、Claude Code、GitHub Copilot等都支援。Linux Foundation仲將佢捐入Agentic AI Foundation做開放標準，白金成員包括AWS、Anthropic、Google等AI巨頭。
Karpathy嘅llm-wiki用三層md架構，單個CLAUDE.md攞到5萬star
Cloudflare實測：同一篇博客HTML用16180個token，轉md只要3150個，壓低80% token。呢啲數據都話明md先係AI時代嘅源代碼。
Cloudflare實測：一篇博文token省80%
html黨嘅理據：空間信息同動態體驗
Thariq提出三條硬論據：第一，空間信息——diff、流程圖呢啲有空間維度嘅信息，md壓扁成文字，HTML可以左右對照，理解效率高好多。
第二，動態體驗——產品原型要睇動畫效果，文字描述冇用，要親眼睇
第三，結構化閲讀——可摺疊章節、tab代碼塊、邊欄術語表，令文檔從「掃一眼」變做「真係會讀」。
Anthropic嘅Live Artifacts將HTML升級成持久化、可交互嘅dashboard
Thariq話：「用HTML嘅真正原因係感覺自己喺AI協作中『在場』。」呢啲證據硬淨，但作者指出，佢哋回答嘅係「俾人睇咩」嘅問題。
Thariq原文：Each one trades a document you'd skim for one you'd actually read
真問題：md生產，HTML消費
兩邊都贏咗，因為佢哋各自回答唔同問題。md黨答「用咩寫」，HTML黨答「俾人睇咩」。呢個先係真正嘅分工。
Thariq自己就係活樣本：3月推md技能，5月推HTML，同一人兩端各自登頂
Karpathy同Lex Fridman嘅組合都係內核md、外殼HTML，唔係取代，係互相加強。
生產端極端輕快，消費端極端豐富，中間唔使折中
實戰工具：huashu-md-html
作者整咗個Claude Code skill叫huashu-md-html，開源GitHub，MIT License。佢做嘅係一件事：令你可以隨時喺md同HTML之間切換，唔使站隊。
- 1 能力一：任意格式轉md——封裝微軟markitdown，支援20多種格式，一條命令python any_to_md.py file.pdf。
- 2 能力二：md轉精美HTML——封裝Pandoc加4套手工調嘅CSS主題：article（Tufte編輯型）、report（出版級白皮書）、reading（Medium極簡型）、interactive（側邊欄長文型）。
- 3 能力三：HTML轉md——雙引擎，博客用trafilatura，產品頁用markitdown，保留metadata同連結。
每套主題都過咗反AI slop檢查，冇紫漸變、冇emoji當圖標、有出版社品位
作者嘅橙皮書系列就係用呢個分工：寫作時用md，構建時轉html再編譯epub/pdf。讀者得到靚排版，但作者檢視嘅永遠係乾淨嘅md。
橙皮書系列：寫作用md，構建用HTML，讀者睇靚排版
琴日，Claude Code團隊嘅Thariq出咗篇爆文，標題叫：HTML係新嘅markdown。佢話佢幾乎唔再寫markdown文件，反而叫Claude Code幫佢整HTML。
呢篇長文喺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知點樣做嘢。一年時間俾60,000多個開源項目採用，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嘅語言標籤裏面，連個名都冇。
呢幾個方向嘅事實，我覺得完全可以得出「md先係呢個時代嘅源代碼」嘅結論。
但html黨都有道理。
Thariq嗰篇爆文我讀完，佢嘅幾條論據我都同意。
第一係空間信息。diff、調用圖、架構圖、流程圖，本來就係有空間維度嘅信息，md將佢哋壓扁成一行行字。同一份diff，叫AI渲染成左右對照嘅html頁面，理解效率根本唔係同一個層次。
第二係動態體驗。我做產品原型時叫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唔係替代關係，係分工關係。
以前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係產物，呢個係一個工作流程問題，唔係站隊問題。
我自己最直接嘅活樣本係橙皮書系列。
橙皮書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團隊的Thariq發了篇爆文，標題叫：HTML是新的markdown。他說他幾乎不再寫markdown文件了，轉而讓Claude Code給他生成HTML。
這篇長文在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的語言標籤裏，連個名字都沒有。
這幾個方向的事實，我覺得完全可以得出「md才是這個時代的源代碼」的結論。
但html黨也有理。
Thariq那篇爆文我讀完，他的幾條論據我都同意。
第一是空間信息。diff、調用圖、架構圖、流程圖，本來就是有空間維度的信息，md把它們壓扁成一行行的字。同樣一份diff，讓AI渲染成左右對照的html頁面，理解效率根本不是一個量級。
第二是動態體驗。我做產品原型時讓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不是替代關係，是分工關係。
以前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是產物，這是一個工作流問題，不是站隊問題。
我自己最直接的活樣本是橙皮書系列。
橙皮書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同生態。