谁是 AI 时代的格式之王?Markdown vs HTML 的终极对决
谁是 AI 时代的格式之王Markdown vs HTML 的终极对决最近Anthropic Claude Code 团队的工程师 Thariq Shihipar 发了一篇文章标题就叫「HTML 回来了」。他的观点很直接Markdown 作为 AI Agent 输出格式的时代正在悄悄结束。这话说出来掀起了一场小型格式战争。Markdown 曾经是「天选格式」Markdown 爆火于 AI 时代绝非偶然。它同时满足了三个苛刻条件人类可读不渲染也能看懂# 标题、**加粗**一眼明了机器友好LLM 训练数据里大量 Markdown模型天然会写轻量便携纯文本版本控制友好哪里都能跑于是一段时间里几乎所有 AI 工具默认输出 Markdown技术社区也形成了共识Markdown 就是 agent-native 格式。但有一个问题在悄悄变大AI 的输出越来越复杂了。早期的 AI 助手你问它「解释一下什么是 Docker」返回几段文字Markdown 完全够用。但今天的 Claude Code、Cursor、Copilot产出的是PR review 报告、系统架构分析、多维度数据对比、带交互的调试面板……这些内容塞进 Markdown就变成了一堵没人愿意仔细看的文字墙。信息量越大Markdown 越力不从心。HTML被遗忘的老将意外翻红Thariq 的核心论点是当你对 Claude 说「用 HTML 格式输出」你会得到一个完全不同层次的结果。他举了一个例子用 Claude 做 PR review如果让它输出 HTML它会生成带颜色标注的 diff 对比新增绿色删除红色折叠展开的代码段风险等级分类的可排序表格模块化的架构注释同样的信息Markdown 版本是「一大块文字 普通代码块」HTML 版本是一个可以直接在浏览器打开的交互式报告。HTML 的优势在于能力MarkdownHTML色彩与样式❌ 无✅ CSS 全支持表格排序/筛选❌ 静态✅ JS 交互SVG 图表❌ 不支持✅ 内嵌折叠区域❌ 不支持✅details布局控制❌ 线性✅ flex/gridAnthropic Artifacts、OpenAI Canvas、Vercel v0 同步押注「视觉化输出」——这不是一个人的孤注一掷而是整个行业的方向。等等Markdown 真的输了吗别急。这场争论里最清醒的声音反而来自评论区一位叫justanemptyvoice的用户他说“Agent 之间通信用 YAML/JSON非结构化内容用 Markdown输出给人看用 HTML人类输入给 Agent 用 Markdown。不同消费者不同最优格式。”这才是真正的工程思维。Markdown 和 HTML 解决的根本不是同一个问题。还有一个技术细节被忽视了真正决定 Agent 效率的是accessibility tree去掉技术包装的精简 DOM而不是 HTML 本身。如果讨论的是 Agent 读取信息、而不是人类阅读输出Markdown 依然更高效。格式战争的本质消费者是谁让我们把问题拆清楚场景一Agent → Agent机器消费最优结构化数据用 JSON/YAML非结构化文本用 MarkdownHTML过重没必要场景二Agent → Human人类消费简单内容Markdown 渲染后完全够用复杂内容图表、对比、交互HTML 明显占优这正是 Thariq 说的场景他没有说错场景三Human → Agent人类输入Markdown 或自然语言简洁就是美德Markdown 「最大优势是人类易编辑」这个论点在 AI 时代确实在弱化——因为人们越来越多地让 AI 来编辑 AI 的输出而不是自己动手。真正值得关注的趋势这场格式之争背后有一个更深层的信号AI 输出正在从「文档」变成「界面」。Markdown 是文档时代的产物它的心智模型是「写下来给人读」。HTML 的心智模型是「搭一个界面让人交互」。当 AI 可以一次性生成 PR review 报告、架构图、数据仪表盘——这些东西的本质已经不是文档而是临时 UI。这也是为什么 Anthropic 重金投入 Artifacts为什么 Cursor 在做 rich preview为什么 v0 直接生成可运行的 React 组件。结语Markdown 没有死它只是找到了自己真正的位置轻量文档、Agent 内存、代码注释、版本控制友好的场合它依然无可替代。HTML 也没有「回归」它只是在 AI 输出变得足够复杂之后终于有了用武之地。**格式之争本质是消费者之争。**搞清楚谁在读这份输出——是机器还是人、是简单阅读还是复杂交互——答案就自然浮现了。下次让 Claude 写报告的时候不妨试试在 prompt 后面加一句「用 HTML 格式输出」。你可能会对结果感到惊喜。参考资料Thariq Shihipar (Anthropic Claude Code team)「Why HTML Beats Markdown for Claude Output」Reddit r/myclaw 讨论「Markdown is not the agent god format anymore… HTML is back.」