Markdown一直是AI与人类沟通的主流格式——简单、便携、易编辑。但Anthropic的Claude Code团队最近抛出了一个反直觉的观点：Markdown已经不够用了，HTML才是AI协作的终极输出格式。
这篇来自Anthropic技术成员Thariq Shihipar的深度分享，揭示了Claude Code内部团队的真实工作流，以及他们为什么集体转向HTML。
Markdown的隐形天花板
Markdown确实有它的优点：语法简单、到处都能打开、支持基础富文本。Claude甚至已经能把ASCII图画得很漂亮。
但当AI的能力越来越强，Markdown的限制也暴露得越来越明显：
- 可读性瓶颈：超过100行的Markdown文件，连作者自己都不想读完，更别说让团队其他人看了
- 可视化匮乏：AI只能用ASCII或Unicode字符”估算”颜色和图形，效率极低
- 分享困难：浏览器不原生渲染Markdown，发邮件或消息时只能当附件
- 编辑依赖人：Markdown最大的优势是”人容易编辑”，但现在很多文件作者根本不手动改，而是让Claude来改
HTML的六大碾压优势
Claude Code团队总结出HTML在AI协作场景下的六大核心优势：
1. 信息密度拉满
HTML能承载几乎所有类型的信息：表格数据、CSS样式、SVG插图、JS交互、Canvas绘图、图片嵌入。”几乎没有Claude能读但你无法用HTML高效表达的信息。”
2. 视觉清晰度
HTML可以用标签页、插图、链接来组织复杂结构，甚至可以做到移动端自适应。一份200行的Markdown没人看，但一份设计精良的HTML文档，打开率完全不同。
3. 分享零门槛
上传HTML文件后直接分享链接，同事在任何设备上都能打开和查阅。”别人真正读完你的PR说明或规格文档的概率，HTML比Markdown高得多。”
3. 双向交互
HTML可以实现真正的交互：滑动条调整设计参数、旋钮控制算法变量、实时预览效果，甚至一键把修改后的参数复制回Claude Code的提示词。
5. 数据摄入能力
Claude Code能读取本地文件系统、MCP连接器（Slack、Linear等）、浏览器历史、Git记录，然后把这些跨源信息整合成一份精美的HTML报告。文章里的所有图表，就是这么生成的。
6. 上下文窗口不是问题
有人担心HTML比Markdown更费token。但Claude Code团队用的是Opus 4.7，上下文窗口高达100万token。”增加的token使用量几乎不可感知，换来的可读性和信息密度却是实打实的。”
五大实战场景
文章给出了HTML在Claude Code中的五大高频使用场景，并附上了GitHub模板库：
场景一：规格规划与探索
不再写单一的Markdown计划，而是用多个HTML文件构成一个”网页规格集”：探索不同UI方案、做数据流mockup、写实施计划。验证阶段也可以把这些文件传给验证agent，让它获得更完整的上下文。
场景二：代码审查与理解
用HTML渲染diff对比、添加行内批注、按严重程度着色、画模块依赖图。PR说明可以直接做成一份交互式审查文档。
场景三：设计与原型
Claude Design本身就是基于HTML的。你可以让Claude用HTML快速sketch设计，然后输出成React、Swift等目标代码。还能做交互动画原型，用滑动条实时调参。
场景四：报告、研究与学习
Claude Code可以跨数据源（Slack、代码库、Git历史、网络）合成信息，生成长篇HTML报告、交互式讲解页面，甚至幻灯片。SVG图表让复杂概念一目了然。
场景五：自定义编辑界面
为特定任务搭建”一次性编辑器”：拖拽排序的ticket看板、带依赖检查的feature flag编辑器、实时预览的prompt调参工具。关键是最后要加一个”导出”按钮，把UI里的改动一键转成可粘贴回Claude Code的格式。
团队的结论：HTML让人更”在场”
Claude Code团队的核心感悟是：HTML让他们对Claude的工作更有参与感。
“随着Claude承担越来越多的工作，我发现自己读计划的仔细程度在下降。HTML恰好解决了这个问题——它让我比以前任何时候都更沉浸在协作中。”
如何开始？
门槛极低。你不需要做任何特殊配置，直接对Claude Code说”make an HTML file”或”make an HTML artifact”即可。关键是想清楚你想让这个artifact做什么、怎么用。初期可以从prompt开始摸索，后期再围绕高频模式构建skill。
Claude Code团队已经开源了一套HTML模板库，覆盖了上述五大场景，可以直接拿来用。
写在最后
这篇文章的潜台词很清晰：AI工具在进化，人与AI的交互媒介也该升级。Markdown是人类写给人类看的格式，而HTML是AI和人类共同工作的画布。
当AI不再只是”帮你写文档”，而是”和你一起规划、设计、审查、迭代”时，你需要一个能承载这种协作深度的格式。HTML，就是那个答案。
原文：https://claude.com/blog/using-claude-code-the-unreasonable-effectiveness-of-html
本文地址：https://www.163264.com/12069
