岳峙亭渊 DIGITAL STUDIO

ESSAY

当Anthropic工程师说用HTML替代Markdown

AI工程 技术观察 工具选择

“技术选择不是教条,而是权衡。“

核心观点 / 起源

2026年5月8日,Anthropic工程师Thariq Shihipar在社交媒体上发布了一个看似平常的技术观点:HTML应该成为AI Agent输出的标准格式,而不是Markdown。

这个观点迅速引发了技术社区的激烈争论。支持者认为这是AI交互界面的必然进化,反对者则坚持Markdown的纯文本优势不可替代。

但这场争论的真正价值,不在于谁对谁错,而在于它揭示了一个更深层的问题:当AI开始大规模生成内容时,我们需要什么样的输出格式?

HTML派的核心论据

Shipar的核心论点很直接:Markdown在处理复杂AI输出时,会变成”认知噩梦”。

想象一下,你让Claude生成一份代码审查报告,涉及20个文件、100处修改。如果用Markdown输出,你会看到一堵密密麻麻的文本墙,需要几分钟才能找到关键信息。

但如果用HTML,你可以看到:

  • 颜色编码的diff对比(绿色表示新增,红色表示删除)
  • 可点击的标签页(按文件分类)
  • 内联的SVG图表(展示代码复杂度变化)
  • 可折叠的章节(隐藏次要细节)

这不是”好看”的问题,而是信息密度的问题。同样的内容,HTML可以让你在几秒钟内抓住重点。

HTML的三大技术优势:

1. 可视化能力 - HTML + CSS可以实现Markdown无法企及的视觉表达:颜色编码、多栏布局、内联SVG图表。

2. 交互性 - JavaScript让HTML输出变成可操作的界面:可点击的元素、动态更新、用户输入。

3. 信息密度 - Shihipar的核心主张:“几乎没有Claude能读取的信息,是你无法用HTML高效表达的。“

Markdown派的反击

但反对者的论据同样有力。他们的核心观点是:HTML解决了短期问题,但牺牲了长期价值。

Markdown的最大优势,是它的纯文本本质。这意味着:

跨越环境变化 - 一个Markdown文件可以在任何文本编辑器中打开,不依赖特定软件或浏览器。

版本控制友好 - Git可以完美追踪Markdown的每一次修改,生成清晰的diff。

可修复性 - 如果AI生成的信息有误,你可以直接编辑Markdown文件,增量修正错误。

反对者引用了Andrej Karpathy的案例:他用Markdown维护了一个40万字的个人知识库,跨越多年依然可搜索、可修改、可追溯。

在Obsidian等知识管理工具中,Markdown的优势更加明显:反向链接、源追溯、持久存储。反对者引用了Vannevar Bush的Memex理念:真正的知识管理,应该存储文档之间的关系,而不是临时的视觉展示。

过程 / 推演

这场争论的表面是技术之争,但本质是使用场景之争

两种不同的需求

HTML的优势场景

  • 单次会话审阅:快速浏览、立即决策
  • 即时消费:看完就扔,不需要长期保存
  • 视觉效率:复杂信息需要快速理解

Markdown的优势场景

  • 长期知识管理:几个月后重新打开和修改
  • 持久存储:跨平台、跨工具的兼容性
  • 版本控制:团队协作、增量修正

成本权衡

HTML的代价:更多token消耗(HTML标签占用额外空间)、版本控制挑战(diff不可读)、工具依赖(需要浏览器或专门渲染器)。

Markdown的代价:视觉表达受限(无法实现复杂布局)、复杂信息展示困难(表格、图表支持有限)、交互性缺失(无法实现动态元素)。

历史的讽刺

有趣的是,Markdown的创始人John Gruber当初设计Markdown时,就把它定位为”转换工具”,最终目标是生成HTML。

但在实践中,Markdown成为了独立的格式,甚至在某些场景下取代了HTML。

现在,Anthropic的工程师提出回归HTML,某种程度上是回到了Markdown的初衷。

实用选择框架

选择HTML,如果你的AI输出需要

  • 立即审阅和决策(代码审查、规划文档)
  • 复杂可视化(图表、仪表板、流程图)
  • 交互性(可点击、可筛选、可排序)

选择Markdown,如果你的AI输出需要

  • 长期存储和迭代(知识库、研究笔记)
  • 版本控制和协作(团队文档、技术规范)
  • 跨平台持久性(不依赖特定工具)

混合策略

  • 短期交互用HTML:AI生成的报告、审查结果、临时分析
  • 长期存档用Markdown:关键决策、知识沉淀、团队文档
  • 关键信息双格式保存:重要内容同时保存HTML和Markdown版本

结语 / 反思

Anthropic工程师的观点,不是要”消灭Markdown”,而是揭示了AI输出场景的多样性。

当AI开始大规模生成内容时,我们需要的不是单一的”最佳格式”,而是针对不同场景的最优选择

HTML和Markdown不是对立的,而是互补的。它们各自解决了不同的问题:

  • HTML解决了”如何快速理解复杂信息”的问题
  • Markdown解决了”如何长期管理和迭代知识”的问题

真正的智慧,不是选边站队,而是理解每种工具的边界,在合适的场景使用合适的格式。

这场争论的最大价值,是提醒我们:技术选择不是教条,而是权衡。


参考资料