
这篇文章在开发者社区引起了不小的讨论,有人深以为然,有人觉得小题大做,也有人困惑:这不就是个格式选择吗?
但我认为,Thariq 触及了一个更深层的问题,只是他自己可能也没完全展开来说。
当 AI 的输出格式从"对话"演变为"作品"时,我们与 AI 的关系正在发生根本性的变化。
一、Thariq 的核心论点
先来简单总结一下 Thariq 的观点。
作为 Claude Code 的工程师,他发现随着 AI 能力增强,Markdown这个 AI 协作的标准格式开始成为瓶颈:
• 信息密度不足:表格、图表、色彩、交互都无法在 Markdown 中有效表达 • 可读性差:超过 100 行的 Markdown 文档他读不下去,更不用说团队其他人 • 难以分享:Markdown 需要专门的渲染器,不能直接生成链接共享 • 缺少交互性:Markdown 是静态的,而 HTML 可以加入滑块、旋钮、导出按钮
他的解决方案是让 Claude 直接生成 HTML 文件,不只是文档,还包括设计方案的原型、代码审查的可视化报告、交互式数据编辑器等。
HTML的优势我们也是一目了然:
视觉清晰度和阅读便捷性:
随着 Claude 能够处理更复杂的工作,它编写的规范和计划也越来越长,实际上我们可以发现自己通常不会阅读超过 100 行的 Markdown 文件。
但是 HTML 文档更容易阅读,Claude 可以以可视化的方式组织结构,使其非常适合使用标签、插图、链接等进行导航。
它甚至可以响应移动设备,因此您可以根据自己的设备以不同的方式阅读它。

分享的便捷性:
Markdown 文件很难共享,因为大多数浏览器无法很好地原生渲染它们,通常需要将它们作为附件添加到电子邮件或消息中。
使用 HTML,只要上传文件(例如上传到 S3),就可以轻松分享链接,您的同事可以在任何需要的地方打开并轻松引用它。
如果你的规范、报告或公关稿是用 HTML 编写的,那么别人真正阅读的几率会高得多。
双向互动:
HTML 允许您与文档进行交互,例如,您可以要求文档添加滑块或旋钮来调整设计,或者允许您调整算法中的不同选项以查看效果。
您还可以要求文档允许您将这些更改复制到提示框中,然后粘贴回 Claude Code。

Claude Code 的优势在于它能读取你的文件系统、MCP 工具、Git 历史,从而生成上下文更丰富的 HTML 输出。
当然,Thariq 也很坦诚地列出了 HTML 的缺点:token 消耗更高(2-4 倍的生成时间)、版本控制下的 diff 难以审查,但他认为这些成本换来的沟通效率是值得的。
到此为止,这都是Thariq一个有趣的实践分享,但我认为这背后有更多值得挖掘的东西。
二、从"对话"到"创作":输出介质的变化正在重塑协作关系
Thariq 在文章末尾说了一句话,我认为是全文最重要的:“用 HTML 后,我反而比 Markdown 时代更有掌控感。”
这句话值得深思。
Markdown 的本质是一种对话协议。它的设计目标是让人和 AI 能以极低的成本来回交换信息,你写一段话,AI 回复一段 Markdown格式简单到几乎不需要处理,注意力全在内容上,这是一种会话关系。
HTML 的本质则是一种创作输出。当你让 AI 生成一个 HTML 文件,你不再是在"聊天",而是在"制作",这个文件可以被分享、被迭代、被嵌入更大的工作流中,它是一种作品关系。
这两种关系没有高下之分,但它们截然不同。
Thariq 的转变反映了一个趋势:随着 AI 能力的提升,我们与 AI 的互动正在从"对话"向"创作"迁移。
我们不再满足于 AI 告诉我们答案,而是希望 AI 产出可以直接使用、可以交付、可以进一步加工的东西。
这也解释了为什么 Thariq 说 Markdown "方便编辑"的优势对他不再重要,因为他根本不再自己编辑了,而是让 AI 在迭代中直接修改 HTML,他用的是"创作-反馈"循环,而不是"对话-编辑"循环。
三、HTML 作为"共享心智模型"
Thariq 在文章中提到 HTML 可以承载更多信息类型,但他没有深入分析一个关键点。
HTML 之所以有效,不是因为它在视觉上更丰富,而是因为它能作为人类和 AI 之间的"共享心智模型"。
大家可以想想看:当 Claude 生成一个 Markdown 计划时,它是一段线性文本。你必须从头到尾读完,在脑子里建立整个架构图,但如果 Claude 生成的是一个包含 SVG 流程图、交
互式代码片段、带标签分类的 HTML 页面,你可以在视觉上一眼抓住结构,通过交互测试边界情况,通过导航跳转到感兴趣的部分。
这就是所谓的认知卸载(cognitive offloading),把理解成本从人脑转移到介质上。
HTML 的丰富表达能力让 AI 能够"替你思考"信息的组织方式,你只需要验证和决策。
这引出一个有趣的推论:AI 生成内容的"可消费性"和它的信息密度之间,可能存在一个最优平衡点。
Markdown 信息密度低,但消费成本也低(渲染快、加载快),HTML 信息密度高,但消费成本也高(需要浏览器、需要加载、需要交互),Thariq 明显选择了高密度高成本的一端,但这不一定适合所有场景。
四、Thariq 没提到的批判性视角
Thariq 的文章是一篇实践分享,不是学术论文,所以也不苛求全面性。
但要从他的经验中提炼出对自己有用的东西,我有几个维度想要补充:
1. 可访问性的代价
HTML 在视觉上更丰富,但对屏幕阅读器、对低带宽环境、对纯终端工作流来说,它反而是倒退。
Markdown 可以用 cat 在终端直接阅读,可以轻松 grep,可以用任何文本编辑器处理。
而HTML 需要图形化浏览器,需要 CSS 渲染,需要 JavaScript 执行。
Thariq 的"信息密度"和"可访问性"之间存在一个取舍,这个取舍在高密度场景下可能值得,但不应该被忽视。
2. 团队协作中的门槛
Thariq 是 Claude Code 的工程师,有极高的技术素养和自由度。
但对于团队协作来说,引入 HTML 意味着引入一个较高的门槛,不是每个人都能或愿意在浏览器里打开你的 HTML 文件,更不用说编辑它。
Markdown 的一大优势是低门槛:任何人都能打开、阅读、修改。
当你把输出格式从 Markdown 切换到 HTML,你实际上在提高参与协作的门槛。
3. token 成本的真正问题
Thariq 提到 HTML 的 token 消耗是 Markdown 的 2-4 倍,但他认为在百万级上下文窗口下可以忽略。
这在技术上是正确的,但 token 成本不只是数量问题,生成 HTML 需要 AI 做更多的决策。
每一个 CSS 属性、每一个 DOM 结构、每一个交互逻辑都需要模型"思考",这就可能导致模型在复杂 HTML 中产生更多幻觉或错误。
换句话说,HTML 增加了输出空间的维度,而维度越高,模型犯错的可能性越大。
4. 自身感觉驱动的工具选择
Thariq 坦承使用 HTML 更有趣,这让他更投入,我认为这可能是最诚实也最重要的理由,但也是最容易被忽视的。
在 AI 协作这种高度创造性的活动中,情感因素对产出质量的影响可能比任何技术指标都大。
如果你发现用某种方式工作让你更投入、更愿意花时间去打磨产出,那这个理由本身就足够充分。
五、从 Thariq 的实践中可以学到什么
撇开"HTML vs Markdown"这个具体争论,我认为 Thariq 的实践给出了几个更通用的原则:
1. 输出格式应该由消费端决定,而不是生产端。
Thariq 选择 HTML 是因为他"读不下去"Markdown 了,消费端的痛点驱动了格式变革。
这听起来理所当然,但在实际工作中,我们往往默认使用最方便的格式(Markdown),而不去思考读者是否需要更好的体验。
2. AI 的产出不应该是"答案",而应该是"工件"。
Thariq 让 Claude 生成 HTML 文件,而不是在对话窗口里输出文本,他从"提问-回答"模式切换到了"请求-制作"模式。
这种模式的变化让每次互动都产生了可以积累、可以分享的产出。
3. 与 AI 协作的流程本身需要设计。
Thariq 描述了一个多阶段流程:头脑风暴 → 原型 → 实施计划 → 新会话执行。
这不是随意的,而是针对"用 AI 解决复杂问题"这个场景设计的协作协议。
随着 AI 能力增强,如何设计协作流程会比如何写提示词更重要。
4. 工具选择是个性化的,但原则是可迁移的。
你可能不会像 Thariq 一样全面转向 HTML,但你可以问自己:
当前与 AI 协作的格式和流程是否在限制产出质量?
是否存在更好的模式来降低理解成本?
你的消费端体验是否还有优化空间?
六、人机协作的范式变化
Thariq 的文章表面上在讨论"为什么 HTML 比 Markdown 好",但如果只读到这一层,就错过了真正的价值。
他描述的是一种正在演进的人机协作范式,从对话到创作,从文本到工件,从线性到多维。
格式之争永远不会有标准答案。
Markdown 在简洁性上的优势、HTML 在表现力上的优势、以及未来可能出现的新格式,都会在不同的场景中找到自己的位置。
但 Thariq 用他的实践提出了一个值得每个人思考的问题:
你是在和 AI 对话,还是在和 AI 一起创作?
如果你的答案是后者,那么你使用的输出格式可能正在限制你们的创作能力。
Thariq还分享了一个HTML的博客,感兴趣的也可以去看一下。
https://thariqs.github.io/html-effectiveness/
如果你有什么看法,欢迎在评论区里交流。
本文参考了Claude Code 团队的工程师 Thariq 的文章 《Using Claude Code: The Unreasonable Effectiveness of HTML》,文中观点基于他的实践分享,本文在此基础上进行了自己的延伸分析和批判性讨论。
https://x.com/trq212/status/2052809885763747935?s=20
夜雨聆风