Anthropic负责Claude Code的Thariq Shihipar近日发文表示，AI代理的输出格式应从Markdown进一步转向HTML，这一观点引发业内关注。

在他看来，Markdown虽然已成为与AI代理协作时最常用的文档格式，但其局限也越来越明显。

Thariq Shihipar称，一旦Markdown内容超过百行，阅读体验就会明显下降；在需要呈现可视化内容、配色方案或图表时，Markdown的表达能力也较为有限，分享链路同样不够顺畅。随着直接手动编辑文件的场景减少、越来越多改动交由Claude完成，Markdown“便于编辑”的核心优势也在减弱。

他将HTML的优势概括为四个方面。

首先是信息承载能力更强。HTML可以呈现表格、CSS样式、SVG插图、JavaScript交互、空间数据以及图片等多种内容。Thariq Shihipar指出，过去Claude在Markdown中只能借助Unicode字符勉强表达颜色，或用ASCII绘制示意图，这类低效做法在HTML中可以避免。

其次是可读性更高。借助标签页、插图和超链接，HTML能够构建更清晰的可视化结构，并支持移动端自适应展示。他认为，相较于组织内部那些往往难以被完整读完的长篇Markdown文档，HTML更有机会真正被用户打开并读下去。

第三是分享更方便。Markdown无法被浏览器直接原生渲染，很多时候只能以附件形式发送；而HTML上传至S3等存储位置后，可以通过单一链接直接分享。他表示，这将明显提高同事查阅规划文档、报告以及PR说明材料的意愿。

第四是交互式操作能力更强。HTML文档可以加入滑块、按钮等组件，直接调整设计选项，再将结果反馈给Claude Code，这类工作流很难通过Markdown实现。

Thariq Shihipar表示，自己已经在规划、代码评审、设计原型、报告以及定制化编辑界面开发等多个场景中使用HTML。在规划阶段，他会把不同方向的方案并排放入同一个HTML文件，便于快速横向比较。

在代码评审场景中，他认为，相较于GitHub默认展示改动的diff视图，HTML格式的说明文档更适合呈现代码变更的背景和意图，因此会在每个PR（Pull Request）中附上HTML说明文档。至于定制化编辑界面，他会用HTML制作一次性编辑工具，例如可拖拽卡片、基于表单的配置编辑器，并在最后加入“复制结果”按钮。

谈及为何选择Claude Code，他解释称，这一工具能够获取文件系统、MCP（如Slack、Linear等）、Git历史记录以及浏览器等多维上下文信息，并据此生成HTML内容。

不过，他也承认，HTML并非没有代价。与Markdown相比，HTML的生成耗时会增加至原来的2至4倍，版本比对更复杂，Token消耗也更高。即便如此，他仍表示，采用HTML后，自己反而能更深入地介入Claude的工作过程。此前他担心，一旦自己不再逐字细读计划文档，决策可能会越来越多地交给Claude；但现在，他反而更清楚Claude到底在做什么。