Anthropic Claude Code 团队的核心工程师 Thariq Shihipar 近日分享了一个工作流转变：将 AI 的输出格式从 Markdown 全面切换到 HTML。作为几乎在 X 上首发 Claude Code 所有重大功能更新的团队骨干，他的这个建议值得认真考虑。

Thariq 曾是 YC W20 创始人（游戏领域，融资 1700 万美元），MIT Media Lab 出身，现在负责 Claude Code 的核心开发。他为什么做出这个转变？

Markdown 正在成为瓶颈

Markdown 一直是 AI Agent 与用户沟通的首选格式——简单、跨平台、支持基础富文本、方便手动编辑。但当 Agent 的能力越来越强，Markdown 的局限性也越来越明显。

超过 100 行的 Markdown 文档，Thariq 说他基本读不下去。他想要更丰富的可视化、颜色和图表，以及更方便的分享方式。而 Markdown 最大的优势"人好编辑"，在 Agent 已经能处理大部分修改工作的今天，也基本失效了。

HTML 的五大优势

1. 信息密度大幅提升

HTML 能承载的信息远超过 Markdown：表格数据、CSS 设计、SVG 插图、代码片段、交互元素、工作流程图、空间数据、图片——几乎没有什么信息是 Claude 能理解但 HTML 表达不了的。这让模型能够把深度信息高效地传达给你。

如果不使用 HTML，模型就会在 Markdown 里做一些勉强的事，比如用 ASCII 画图，或者用 Unicode 字符"估算"颜色效果。

下面这张图展示了 Claude Code 在 Markdown 中试图用 Unicode 字符"估算"颜色效果，看起来相当勉强：

2. 视觉清晰度和可读性

HTML 文档可以用 tab 分组、插图辅助、链接导航来组织结构，甚至做成响应式布局。Thariq 表示，同样的内容，HTML 版本他愿意读完，Markdown 版本超过 100 行就直接跳过。

3. 分享更方便

Markdown 文件大部分浏览器不能原生渲染，通常要作为附件发送。HTML 文件上传到任意托管服务后，分享链接即可，同事在任何设备都能打开。

一个 spec、报告或 PR 说明真正被人读到的概率，HTML 比 Markdown 高得多。

4. 双向交互能力

HTML 可以让文档变成可交互的——添加滑块调整设计参数、按钮复制配置、实时预览效果。Thariq 举的例子：让 Claude 做一个动画按钮原型，通过滑块调整动画参数，满意后一键复制参数回 Claude Code。

5. 数据摄入能力强

Claude Code 能扫描你的代码库、MCP 连接、Git 历史等，生成包含实际数据的 HTML 报告。Thariq 写这篇文章时，就让 Claude Code 扫描了他所有的 HTML 文件，自动分类并生成图表。

实际应用场景

Spec、规划和探索

不再写简单的 Markdown 方案，而是让 Claude 生成一组 HTML 文件：先头脑风暴不同方案，再深入展开选定的方向，做 mockup 和代码片段，最后形成实施方案。验证 Agent 也能读入这些文件，获得更完整的上下文。

示例 prompt：

Generate 6 distinctly different approaches — vary layout, tone, and density — and lay them out as a single HTML file in a grid so I can compare them side by side.

代码审查和理解

用 HTML 渲染 diff、添加注释标注、画流程图、展示模块关系。Thariq 现在每个 PR 都会附一个 HTML 代码解释文件，比 GitHub 默认的 diff 视图更直观。

设计和原型

Claude 先用 HTML 画出设计稿，再转写成 React、Swift 等目标语言。还可以做交互原型，比如动画效果、操作反馈等。

报告、研究和周报

让 Claude 搜索 Slack、代码库、Git 历史，生成高度可读的 HTML 报告——可以是长文档、交互式页面或幻灯片，配合 SVG 图表可视化。

一次性编辑器

为特定任务定制专属编辑器：重新排序 Linear 工单、编辑 feature flag 配置、调试 prompt 模板。关键是结尾要有导出功能，把 UI 操作结果变回可粘贴回 Claude Code 的文本。

常见问题

HTML 不是更费 token 吗？ 确实，但 HTML 表达能力更强，而且你真的会去读，整体产出质量更好。在 Opus 的百万级上下文窗口下，额外 token 消耗几乎感知不到。

生成速度更慢？ HTML 生成时间约是 Markdown 的 2-4 倍，但 Thariq 认为结果值得。

版本控制怎么办？ 这是 HTML 最大的短板——diff 噪音大，review 比 Markdown 困难。

怎么匹配公司风格？ 让 Claude 读取代码库生成设计系统 HTML 文件，作为其他输出的样式参考。

核心原因：保持在 Loop 里

Thariq 分享的最后一段话或许是最核心的原因：

之前我开始担心，因为我不再深入阅读方案了，我只能放手让 Claude 自己做决策。但用了 HTML 之后，我感觉自己比以前任何时候都更在 loop 里。

当 AI 输出的内容你愿意读完、理解、参与讨论，而不是直接放手——这才是 HTML 取代 Markdown 的真正价值。

原文作者：Thariq Shihipar，Anthropic Claude Code 工程师
原文链接：x.com/trq212/article/2052809885763747935
示例集合：thariqs.github.io/html-effectiveness