AI生成的长文没人看？HTML vs Markdown协作格式之争与决策指南

Image

开门见山—— Anthropic 工程师 Thariq Shihipar 只用了 20 个 HTML 文件，就掀起了一场围绕 AI 输出格式的激烈辩论。核心观点十分直接：Markdown 的本质是写给人类编辑的，而 HTML 才是真正面向人类阅读的。当生成文本的责任全由 AI 承担时，HTML 能提供的视觉密度、可浏览性和交互能力，远远拉开 Markdown 一个身位。但社区并不买账，尖锐的反驳同样掷地有声——多人协作编辑怎么办？Token 开销瞬间翻倍又该怪谁？而且这是否只是披着效率外衣的厂商锁定？答案并非非黑即白，真正的解法在于按场景撕开这一对格式，各取所需。

440万

推文浏览

1000+

HN讨论分

17/20

实测胜率

一场推文引爆的格式革命

5 月 8 日，Anthropic Claude Code 团队的工程师 Thariq Shihipar 在 X 上抛出一句话：“HTML is the new markdown。” 伴随这句话的，是 20 个完全由 Claude Code 自动生成的 HTML 文件——没有设计师，没有前端工程师介入。这些产物中，有可拖拽的任务看板、用 SVG 绘制的流程图、带滑块交互动画的参数调节器，以及六套方案并排比较的对比页面。它们共同取代的，正是一行又一行的纯 Markdown 文本。

这条推文在 16 小时内拿下了 440 万次浏览、8200 个赞和 15700 个收藏。在 Hacker News 上，关于它的讨论一天之内就飙升至 1000 分。知名开发者 Simon Willison 甚至公开表示，这让他“重新审视了自己三年来习惯使用 Markdown 的默认思维”。这早就不是一次简单的格式偏好之争——它直指一个根本性的问题：AI 到底应该用什么样的形式和我们沟通？

Thariq 自己也承认了一个几乎每个人都心知肚明的事实：超过 100 行的 Markdown 文件，他根本不会读完。这在开发者群体中具有相当的普遍性。问题并不出在内容质量上，而出在格式本身对人类的适配方式上——Markdown 默认读者会从头到尾按顺序逐行吸纳，而人类处理信息时根本是跳跃式的扫描。

HTML 的四个不可替代的优势

Thariq 的整套论证可以被浓缩成一句话：Markdown 更像一份报告，而 HTML 是一个界面。报告是用来通篇阅读的，界面则是用来定位、操作并继续推进任务的。展开来看，HTML 具备四个 Markdown 无论如何都追不上的能力：

  • 信息密度——HTML 能自然承载表格、富样式排版、SVG 插图和 JavaScript 交互；Markdown 却只能用 ASCII 字符画示意图。在 AI 的视角里，两者只是一串 token 的排列组合；但落在人眼里，这就是“能看”和“根本不想看”的鸿沟。
  • 可浏览的可读性——通过标签页切换、折叠面板、响应式布局，HTML 能把长篇内容组织成一套有导航感的结构。同样的 300 行文本，用 Markdown 可能就是一堵灰色的文字墙，而换成 HTML 则变成了带有目录的文档。
  • 分享零摩擦——浏览器天然就能渲染 HTML。上传到 S3 或任何一个静态托管服务，立刻可以生成一个可直接打开的链接。Markdown 则需要额外的渲染步骤，多这一步操作，往往就意味着打开意愿直接减半。
  • 双向交互闭环——拖动滑块调参、拖拽任务排序、一键导出按钮……HTML 让人不仅能“看”，还能直接“做”。调整好参数后，甚至可以一键复制为 prompt 回传给 AI，形成人机协作的工作流闭环。这已经远远超越了传统文档的定义。

一位开发者在 Medium 上记录了自己的实测：他将 Thariq 分享的 20 个示例 prompt 分别用 Markdown 和 HTML 两种格式输出，结论是 HTML 在 17 个任务中明显获胜。剩下的 3 个算不上真正的败绩——那些输出原本就仅供 AI 内部处理，压根不涉及人类的阅读体验。

不得不回应的三个尖锐质疑

如果事实真的如此一边倒，Hacker News 上的讨论也就不会冲上 1000 分了。社区的反扑牢牢咬住了三个痛点。

质疑一：协作编辑的彻底丧失。
HN 上最高赞的评论来自 tmhrtly：“如果这是一份复杂的规格文档，我希望自己能进去修改它。HTML 文档比 Markdown 难编辑得多——我需要前端技能，或者只能再走一遍 AI 流程。” 这个痛点直击要害。Markdown 在所有文本编辑器里都能直接上手修改，而 HTML 需要专业工具或者再次仰仗 AI。对于那些“人类起草→AI 完善→人类再修改”的工作流而言，Markdown 的编辑轻便性依然无可取代。

质疑二：Token 成本与厂商锁定嫌疑。
ryandsilva 的评论一针见血：HTML 相较 Markdown 会多消耗 2 到 4 倍的 token，而这一事实恰好有利于 Anthropic 的商业模式。Thariq 对此的回应是，Opus 4.7 的 100 万 token 上下文窗口已经让额外成本可以忽略不计。可这个回应隐藏着一个前提——并不是所有人都在用 Opus 级别的模型，也并不是所有人的 API 预算都那么宽裕。Simon Willison 从历史角度给出的解释或许更有说服力：在 GPT-4 时代，8192 token 的限制让 Markdown 的效率优势极其珍贵，而现在上下文窗口扩大了上百倍，这一限制才真正消失。

质疑三：内容臃肿才是病根，格式只是表象。
Planktonne 的评论击中了一个更本质的问题：“在讨论格式之前，先问问内容是不是本身就已经太长了。一份 500 行的规格文档，无论用什么格式都值得怀疑。” 与此同时，arianvanp 还发现了一个值得玩味的悖论：这篇声称“HTML 更好”的观点，在推文里用的却全是截图，而不是可交互的 HTML。而 PhilippGille 则指出了第三条路：CommonMark 标准早已支持内联 HTML，你完全可以在 Markdown 里嵌入 SVG，完全不必做“二选一”的强行割裂。

争议焦点 详解
人类编辑难以参与 编辑 HTML 需要前端技能或再走一遍 AI，而 Markdown 在任何编辑器都能改。
Token 消耗成倍增加 2-4 倍的 token 成本究竟值不值？取决于你手头是否有高容量模型。
问题可能不在格式 内容过长方为原罪。CommonMark 已支持内联 HTML，无需非此即彼。

问题不在于“哪个更好”

各方都有站得住的道理，因为他们争论的根本不是同一件事。一部分人把 AI 输出当成“半成品”——人类自己写 prompt，AI 生成内容，人再亲手编辑，然后返回给 AI 修改。在这个循环里，Markdown 轻量与可编辑的特质是实实在在的生产力。另一部分人则把 AI 输出当“成品消费品”——AI 负责调研并生成报告，直接分享给团队成员审阅。在这种场景下，HTML 的可读性和分享的便利性几乎碾压 Markdown。

还有一个被广泛忽视的维度：AI 本身也在消费这些文档。Thariq 在原文中提到：“验证代理同样会读取这些文档。规格已不再是简单的文件，而是代理之间共享的内存。” HTML 天然的结构化信息密度更高，AI 代理从中提取关键信息的效率也更高。从这个意义上讲，HTML 对人不只是友好，对 AI 代理同样友好。

Markdown = 报告

  • 适合写作和编辑
  • 偏向线性阅读，超过 100 行就让人想放弃
  • AI 代理也能读，但可提取的结构信息有限

HTML = 界面

  • 适合阅读和审阅
  • 可浏览、可交互、可直接分享
  • AI 代理可高效提取结构化信息

Pasquale Pillitteri 在一篇深度分析中给出了一个相当实用的判断标准：“对独立开发者来说，Markdown 速度更快、更容易随心修改。而对分布式团队而言，HTML 制品是更优越的沟通工具，多花的那点 token 成本，远抵不过减少的沟通回合能省下的时间。”

三条可以立刻上手的决策规则

这场“格式之争”不需要一个单一的赢家。真正有价值的，是分场景的决策框架。

  • 配置和 prompt 文件，坚持用 Markdown。
    CLAUDE.md、AGENTS.md、SKILL.md 这类文件——它们是给 AI 读的指令，必须简短、高度结构化，并且需要人类偶尔手动编辑。Markdown 的简单，在这里是绝对不可替代的。

  • 计划和报告，大胆尝试 HTML。
    任何需要人类仔细阅读、团队集中审阅、跨角色对齐认知的内容，不妨让 AI 直接输出 HTML。你根本不需要懂 HTML，只需要在 prompt 末尾加上一句“生成一个 HTML 文件”就行。

  • 交互式工具，一定要用带 JS 的 HTML。
    需要实时调整参数、排列优先级、对比不同方案？直接让 AI 做一个带按钮和导出功能的单页 HTML。它的沟通效率，胜过十轮反复对话。

Thariq 原文中最容易被匆匆略过的一句话，也许才是整场讨论的真正锚点：“It’s more joyful.” 当 AI 返回的不再是一堵灰色的文字墙，而是一个带有色彩、图表和交互控件的页面时，你确实会更愿意多看几眼。这无关技术，只关乎人性。

参考来源

  • Thariq Shihipar — Using Claude Code: The Unreasonable Effectiveness of HTML (2026.05.08)
  • Hacker News 讨论 (1000+ points) — news.ycombinator.com/item?id=48071940
  • Simon Willison 的链接博客 — simonwillison.net (2026.05.08)
  • Pasquale Pillitteri — HTML vs Markdown in Claude Code (2026.05.09)
  • Chew Loong Nian 的 Medium 文章 — 17/20 实测数据 (2026.05.10)