Claude 团队为什么改用 HTML 了
让大模型输出 Markdown,是用户从 GPT-4 时代延续至今的默认习惯。然而,随着模型上下文窗口的显著扩大,这一默认选项正面临重新评估。2026年5月8日,Anthropic 公司负责 Claude Code 的工程师发布文章,明确建议将输出层的默认格式从 Markdown 切换为 HTML,并详细阐述了背后的技术动因、应用优势及实操建议。
01背景动因:从“省 Token”到“装信息”
在 GPT-4 时代,上下文窗口仅为 8,000 个 Token。由于 HTML 标签的开销较大,Markdown 因其简洁性成为了节省 Token 的最优解。但在 Claude 最新的 Opus 4.7 时代,上下文窗口已扩展至 100 万 Token。这一技术前提的根本性变化,使得“节省 Token”不再是决定输出格式的关键变量。现在的核心考量转变为:哪种格式能装下更多的信息密度,以及输出内容是否能被用户有效查看和理解。
02HTML 的四大核心优势
| 优势维度 | HTML 表现能力 | Markdown 局限性 |
|---|---|---|
| 信息密度 | 单页面可同时容纳图表、代码 diff、注释、UI 组件状态及可勾选清单 | 仅支持段落、列表、链接、代码块和简单表格,超出范围需依赖 ASCII 图或外链 |
| 可读性 | 支持锚点跳转、左右两栏并排、折叠展开,避免长文档单调下滑 | 布局受限,长文档阅读体验较为枯燥 |
| 分享成本 | 单文件分享,接收方点击即可直接查看完整页面 | 接收方需安装 Markdown 渲染插件才能正常阅读 |
| 交互能力 | 一行提示词即可生成滑块、按钮、表单等双向交互控件 | 缺乏原生支持,无法提供真正的交互功能 |
HTML 与 Markdown 在大模型输出场景下的能力对比
03Anthropic 内部的五大应用场景
- 方案规划
将多个候选方案置于同一 HTML 页面并排展示,实现直观对比。 - 代码评审
将代码 diff 转化为 HTML,用不同颜色标识问题严重程度,比 GitHub 默认 diff 更清晰。 - 设计原型
快速生成 UI 草图或交互原型。 - 综合报告
面向非技术人员的执行摘要,嵌入流程图、架构图及高亮代码片段,降低沟通成本。 - 自制编辑工具
构建可拖拽卡片或表单驱动的配置编辑器,通常在末尾添加“复制结果”按钮以便操作。
此外,Claude Code 的数据来源不再局限于本地文件系统,通过 MCP 接入的 Slack、Linear、Git 历史及浏览器历史,均可被 HTML 汇聚成一份直接可读的综合性文档。
04潜在缺点与折中方案
尽管优势明显,HTML 的引入也存在三个主要缺点:生成耗时比 Markdown 多 2 到 4 倍;Token 用量更大导致成本上升;Git diff 视觉混乱,修改一行代码可能导致整页变动,增加 PR 评审难度。
使用场景选择指南
读、看、分享
需要高信息密度的综合展示
涉及图表、流程图或原型演示
需要用户进行点击或交互操作
面向非技术人员的汇报文档


改、追踪、版本管理
需要频繁编辑修改的正式规范
依赖 Git diff 进行代码或文档审查
在普通文本编辑器中直接编辑
需要严格的版本控制与变更追踪
社区提出的折中方案建议:使用 Markdown 编写正式规范并利用 Git 跟踪,同时使用 HTML 编写配套说明文档或用于页面起草。这种按场景分工的方式,既保留了 Markdown 在编辑和版本管理上的优势,又利用了 HTML 在展示和交互上的强项。
05实操建议与 Prompt 模板
文章作者建议不要急于将 HTML 输出封装为 Skill,而是先反复测试 Prompt,明确哪些场景跑得通后再进行封装。为了保持跨 Session 的视觉一致性,可以建立一个包含品牌色、字体和基础组件的 design-system.html 文件,让 Claude 在后续生成时读取该文件。
针对具体应用,以下两条 Prompt 模板可供参考:
- PR 评审场景
Help me review this PR by creating an HTML artifact that describes it. I'm not very familiar with the streaming/backpressure logic so focus on that. Render the actual diff with inline margin annotations, color-code findings by severity and whatever else might be needed to convey the concept well. - 多方案规划场景
Make me an HTML file that lays out 2-3 design directions for this requirement side by side. One column per direction, key decisions as checkboxes I can tick, an "export my choices" button at the bottom.
综上所述,HTML 默认化并非出于审美的考量,而是一种基于操作效率的选择。在文档需要被阅读、查看和分享时,HTML 能提供更高的信息密度、更优的阅读体验和直接的交互能力,收益大于成本;而在文档需要被编辑、查看差异或进行版本追踪时,Markdown 依然是更合适的工具。
当前文章无评论,是时候发表评论了