🤖 AI 跟我学 新手入门
AI 快讯 编译自 simon_willison #AI 输出格式#Claude Code#HTML vs Markdown

Claude Code 团队建议用 HTML 替代 Markdown 作为 AI 输出格式,理由充分

Anthropic 的 Claude Code 团队成员 Thariq Shihipar 撰文力荐用 HTML 替代 Markdown 作为 AI 输出格式,可嵌入 SVG 图表、交互组件等,大幅提升信息可读性。本文解读这一观点,并探讨对中文用户的实用价值。

编译发布 2026/05/21 原文发布 2026/05/08

一句话看懂

Anthropic 的 Claude Code 团队成员 Thariq Shihipar 撰文,力荐用 HTML 替代 Markdown 作为 AI 输出格式,可嵌入 SVG 图表、交互组件等,大幅提升信息可读性。

详细发生了什么

Thariq Shihipar(Anthropic 公司 Claude Code 团队成员)发表了一篇文章,标题是《Using Claude Code: The Unreasonable Effectiveness of HTML》。核心观点很直接:向 Claude 请求输出时,优先要 HTML 格式,而不是 Markdown。

文章里塞满了实例和提示词建议,比如:

“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.”

作者 Simon Willison 在转载时提到,从 GPT-4 时代开始,因为 8,192 token 的限制,Markdown 比 HTML 更省 token,所以他一直默认用 Markdown。但 Thariq 的文章让他重新考虑这个习惯,尤其是输出场景。让 Claude 用 HTML 来解释,意味着它可以嵌入 SVG 图表、交互式小部件、页面内导航等,浏览信息会舒服很多。

Simon 还拿 GPT-5.5 试了试,为一个 Linux 安全漏洞(copy.fail)生成 HTML 解释,验证了 HTML 输出的潜力。

中文圈视角

对中文用户来说,这个建议实操性很强:

  1. 直接能用:Claude 在国内可以通过 API 或部分代理访问,HTML 输出不需要额外工具,浏览器直接渲染。
  2. 平替对比:国内模型像 DeepSeek、Kimi 也支持 HTML 输出,但生成质量参差不齐。Claude 在复杂 HTML 结构(比如 SVG 图表、交互式组件)上更稳定。
  3. 场景落地
    • 编程学习:用 HTML 展示代码 diff、流程图,比 Markdown 的纯文本直观得多。
    • 文档撰写:生成带导航、目录的 HTML 文档,适合技术博客或内部知识库。
    • 数据分析:嵌入交互式图表(比如 Chart.js),不需要额外工具就能可视化。
  4. 盲点提示:中文社区讨论 AI 输出格式时,大多集中在 Markdown 和纯文本,HTML 作为输出格式的潜力被严重低估。

几条值得记住的细节

  • Thariq Shihipar 是 Claude Code 团队成员,文章有官方背景。
  • 示例提示词要求 Claude 生成 HTML artifact 来审查 PR,包含 diff 和严重性颜色编码。
  • Simon Willison 之前写过《Useful patterns for building HTML tools》,但侧重交互工具,不是解释性内容。
  • 作者用 GPT-5.5 为 Linux 安全漏洞(copy.fail)生成 HTML 解释,验证了可行性。
  • 核心优势:HTML 可以嵌入 SVG、交互组件、导航,Markdown 做不到。

一句话总结

下次让 AI 解释复杂内容时,试试要求 HTML 输出,你会得到更直观、可交互的答案。