Markdown 給自己存，HTML 給別人看——Anthropic 為什麼改用 HTML

Markdown 給自己存，HTML 給別人看

我的 Obsidian 裡有 3000 篇 Markdown。讀完這篇我糾結了——Anthropic 自家員工說：別寫 Markdown 給人讀。

資料來源：にゃんたのAIチャンネル — Claude Codeで資料作成！話題の「MarkdownよりHTML」を使う理由

Anthropic 工程師 Tarrick 上週在 X 發了一篇推文，標題就是「Markdown より HTML を使おう」。1000 萬瀏覽。

Markdown 我用了七年

備課用、寫貼文用、做教案用、整理會議記錄用。乾淨、輕量、跟 Git 完美整合。我寫程式的朋友也都用。

但 Tarrick 那篇推文揭穿了一件事——

「Markdown 適合給自己存，不適合給別人看。」

他舉了 Anthropic 內部資料共享的轉變：以前用 Markdown，現在改用 HTML。

六個理由，每個我都中

一、資訊密度：Markdown 塞不下圖表、互動元件、可摺疊的章節。HTML 可以。

二、可讀性：給人一份兩千字的 Markdown，他只會掃過。同樣內容做成 HTML，有顏色、有 anchor、有 nav，他會看完。

三、互動性：HTML 可以做 slider、可拖拉的 discussion board、勾選表單。Markdown 只能用看的。

四、跨裝置分享：URL 一發，手機桌機都能讀，不用安裝 Obsidian、不用懂 GitHub。

五、和 Claude Code 天作之合：用 MCP 從 Slack、Notion、Excel 抓資料，直接生成 HTML 報告。中間不用人手轉檔。

六、做得開心：Claude Code 寫出來的 HTML 比我預想的漂亮。每次都會驚喜。

自省一下

我寫了多少份「沒人讀完」的 Markdown？

• 家長日的 AI 工具介紹文，4000 字，留言區安靜。
• 期末教學報告，2 萬字，主任只挑頭尾看。
• 給其他老師的 Claude Code 入門指南，3000 字，沒人按連結。

不是內容不好。是 Markdown 對「不是同類人」太冷。

如果是 HTML——配色、目錄、可摺疊、可滾動、嵌入 demo 動畫——同樣的內容，會被讀完。

拉回教學現場

學生交報告也是一樣。

我以前堅持要學生交 Word 或 PDF。改作業改到頭很大，學生收到批改後也沒人開來看第二次。

去年改成「期末作業可交互動式 HTML」——一兩個學生試了。我發現他們在做的過程中，會主動回頭改內容，因為「介面不好看，他自己也不想看」。

柯維《七個習慣》第二個習慣叫「以終為始」——做任何事之前，先想終點。

我以前以為「終點」是「我寫了一份精美文件」。Tarrick 提醒我，真正的終點是「對方真的讀進去、用得到」。Markdown 滿足前者，HTML 才滿足後者。

代價在哪？

HTML 比 Markdown 消耗 5 倍 token。如果你是 Claude Pro 用戶，免費額度會早一週用完。

但這是公平交易——你多花一點 token，換對方真的把你的東西讀完。

我的結論

Markdown 給自己存。 HTML 給別人看。

我不會丟掉我的 3000 篇 Obsidian。但下次要交給別人的東西，我會先想——這該不該變成 HTML？