智能体协作不一定非用 Markdown:Anthropic 工程负责人为何看好 HTML 输出

智能体协作中,HTML 可能比 Markdown 更适合复杂输出和人工复核。

原文标题:Anthropic 负责人:HTML 比 MD 更利于人类跟进智能体协作流程InfoQ2026年7月5日 10:21 新加坡 6人

原文作者:AI前线

冷月清谈:

Anthropic Claude Code 团队工程负责人 Thariq Shihipar 提出,在智能体参与更复杂工作流后,Markdown 作为默认输出格式的局限正在显现:长文档难读、信息层级不够直观,也容易导致开发者跳过人工复核。相比之下,单文件 HTML 可以承载更丰富的视觉结构、交互组件、SVG 图表和页面导航,更适合需求梳理、方案规划、代码审查、数据分析、原型设计等需要人类持续跟进的场景。

这一观点引发开发者讨论。支持者认为,HTML 能降低认知负担,让人更容易理解智能体的决策过程;反对者则担心 HTML 带来安全风险、源码可读性下降、Token 开销增加以及 Git diff 不友好等问题。文章也提到,随着模型上下文变大、成本降低,过去 Markdown 省 Token 的优势可能不再是唯一优先级。核心争议并不是 HTML 要取代 Markdown,而是智能体输出是否应根据任务目标选择更合适的呈现方式。

怜星夜思:

1、如果让 AI 默认输出 HTML,而不是 Markdown,你会更愿意认真审阅它的结果吗?
2、Markdown 的简洁和 HTML 的交互性,哪个更适合未来的智能体工作流?
3、AI 生成 HTML 输出会不会带来新的安全和维护问题?应该怎么控制?
4、你觉得哪些 AI 任务最适合用 HTML 呈现,哪些任务还是 Markdown 更好?

原文内容

作者 | Bruno Couriol
译者 | 明知山

Claude Code 团队工程负责人 Thariq Shihipar 近期 发表 了一篇题为《使用 Claude Code:HTML 意想不到的实用价值》的文章。文中提出,HTML 具备更丰富的可视化效果、色彩展示与交互性,在诸多场景下能提升人类与智能体之间的沟通效率,相较默认输出格式 Markdown 优势尤为突出。在智能体驱动的工作流中,目标沟通、需求细化、输出结果复核正逐步成为流程效率的瓶颈。

Shihipar 道出了开发人员经常需要面对的一个痛点:

随着智能体变得越来越强大,我发现 Markdown 格式的局限性也愈发凸显。具体来说,我发现阅读超过一百行的 Markdown 文件非常困难。

而且现在我基本不会手动编辑这类文件,只把它们当作需求规范与参考文档使用。

我开始更倾向于将 HTML 作为输出格式,而不是 Markdown,并且也注意到 Claude Code 团队里越来越多同事都在采用这种方式。

主张使用 HTML 的论据建立在这一客观发现之上:随着智能体越来越多地被用于复杂且冗长的工作流,输出的复杂性和长度也随之增加,这给人类带来了认知负担瓶颈。支持 HTML 方案的人认为,面对这一挑战,开发者很容易偷懒,直接不经审核就全盘采纳智能体生成的内容,从而可能在日后引发质量、维护和安全方面的问题。

该观点认为,在那些必须人工介入、无法完全自动化的工作流程中(例如目标与执行路径设定、需求调研与细化、分步纠错引导),或是需要人工强制核验、确认结果的场景中,智能体的输出格式应当既能让人快速抓取信息核心与细节,又能贴合用户设定的目标。

相较于 Markdown,Shihipar 更推崇使用单文件 HTML 创建适配当前任务目标、兼具可视化与交互性的工作空间。具体来说,他认为以下各类场景都适合使用 HTML:需求规范制定、方案规划与需求调研;代码审阅与逻辑梳理;界面设计与原型开发;数据探查、分析及可视化;以及所有能够借助定制化交互界面提升处理效率的业务场景。

在这篇博文的 配套文章 中,Shihipar 提供了一个自定义一次性 HTML 输出的示例,用于加快工单分类处理的工作进度:

另一个示例 旨在加速 PR 审查流程。相较于在终端里来回滚动查看内容,HTML 输出页面更便于快速浏览查阅:

Shihipar 的观点在 Hacker News、Reddit 和 Medium 上引发了广泛讨论,开发者们由此分成两派:一派认可 HTML 的高密度可视化展示优势,另一派则警告不要放弃 Markdown 的纯文本简洁性。

针对 Shihipar 提出的初步思路,Simon Willison 提出了他的看法:如今大模型上下文窗口不断扩大,推理速度更快、使用成本更低,默认输出 Markdown 或许已经不再是最优方案。

从 GPT-4 问世以来,我就一直默认要求大多数输出使用 Markdown,当时模型仅有 8192 令牌的上下文上限,Markdown 相比 HTML 更省令牌的优势显得至关重要。

Thariq 的这篇文章让我重新审视了这个习惯,尤其是对于输出来说。如果让 Claude 用 HTML 生成内容,意味着它可以嵌入 SVG 图表、交互式小部件、页面内导航以及各种其他巧妙的方式,让信息更易于浏览。

也有人认为,用 HTML 替代 Markdown 是一种倒退,即便在前述各类场景中也是如此。他们指出了各种弊端:源代码可读性的丧失、不安全的 HTML 带来的安全和基础设施风险、HTML 相比 Markdown 的词元开销,以及 Git 集成欠佳(例如差异对比)。

尽管如此,一些开发人员仍在创建自定义工具(例如,html-artifacts,由 Greg Dogum 开发的开源 Claude 技能,它使用识别启发式方法可根据当前任务切换成 HTML 输出)。

归根结底,Shihipar 的观点可能只是一个 使用合适工具完成工作 的案例:

以上种种都意在说明,我使用 HTML 而非 Markdown 的真正原因是,它能让我感觉与 Claude 的联系更加紧密。随着 Claude 承担的任务越来越多,我发现自己渐渐不再仔细审阅它给出的方案,我希望能有一种方式来持续关注它做成的各项决策,而不是直接交差。HTML 恰好满足了这一需求。

AI 智能体平台正在积极寻求改进人机交互界面的方法,包括在标准文本机制之外增加更多交互式界面。生成式 UI 能够让智能体根据用户需求实时生成定制化交互界面。

查看英文原文:

https://www.infoq.com/news/2026/06/anthropic-html-markdown-agent/

声明:本文由 InfoQ 翻译,未经许可禁止转载。

点击底部阅读原文访问 InfoQ 官网,获取更多精彩内容!

会议推荐

大会限时早鸟票享 8 折专属优惠,现在报名立减 1160,更多详情可扫码或联系票务经理 13269078023 进行咨询。

今日荐文

图片
你也「在看」吗?👇

我站 Markdown。原因很朴素:可读、可 diff、可复制、可长期保存。HTML 如果没有规范,很容易变成一堆难维护的临时页面,今天看着爽,半年后没人知道怎么改。

3 个赞

会,而且大概率会先从‘谁写的这坨内联 CSS’开始崩溃。控制方法也简单:模板化、组件化、白名单化。别让模型自由发挥成赛博小报网页就行。

1 个赞

针对“默认输出 HTML”这个问题,我觉得要看任务。需求评审、PR 说明、数据分析报告用 HTML 很合适;但写 README、接口文档、会议纪要,我还是要 Markdown。不是格式越炫越好,而是要看后续怎么维护。

2 个赞

这个问题有点像问米饭和火锅哪个更适合吃。日常吃饭 Markdown 够了,朋友聚餐上 HTML。别天天火锅,也别指望白米饭解决所有情绪价值。

1 个赞

我反而有点警惕。HTML 看起来更舒服,但也可能把问题包装得更漂亮。AI 生成内容最怕‘视觉上很完整,逻辑上很糊弄’,所以审阅意愿可能会提高,但审阅质量不一定自动提高。

3 个赞

说实话,会。人类就是视觉动物,按钮、颜色、分栏、流程图一上来,比一大坨井号和列表舒服太多了。只要别给我整成企业内训 PPT 风,我愿意多看两眼。

1 个赞