AI Agent开始嫌弃Markdown?

作者｜林析源、陆榅书 

编辑｜厦末（实习生）

AI开发者社区最近吵起来的不是模型参数，也不是上下文长度，而是一个看上去很老派的问题：Agent到底应该默认输出Markdown，还是HTML。

这个争议之所以有意思，是因为它发生在Claude Code这类工具开始变得日常之后。

过去，大模型主要输出答案，Markdown已经足够。标题、列表、代码块、表格，能把文本组织清楚，也能被Git、文档系统和编辑器接受。

但Agent不一样。Agent输出的不再只是答案，而是计划、审查结果、产品原型、数据报告、流程界面和可执行任务面板。

当输出长度超过一百行，Markdown的优势开始变成劣势。

它仍然轻量，但不一定好读；它仍然可编辑，但不一定能让非技术人员愿意读完。Thariq提出HTML比Markdown更适合Agent沟通，核心不是说Markdown落后，而是说Agent的默认交付物已经从文档迁移到界面。

这背后的路线分歧可以拆成三层。

1、短期看成本，Markdown仍然占优。它便宜、稳定、可diff、可复制，天然适合工程团队做版本管理。一个需求文档、一个代码审查意见、一个长期维护的项目记忆，Markdown更容易被人类和机器共同编辑。

HTML的问题也很明显：生成更慢，源码更难审，样式一多就会变成视觉债务。Agent一旦为了好看生成大量CSS和嵌套结构，后续人工改动成本会明显上升。

2、中期看体验，HTML优势更大。Agent正在从命令行助手变成工作台。

产品经理要看路线图，设计师要看交互稿，研究员要看可视化报告，运营要看数据卡片，老板要看结论摘要。这些场景里，用户并不关心源码是不是简洁，而是关心信息能不能一眼分层，能不能点击筛选，能不能展开细节，能不能把复杂结论变成可读界面。

3、长期看范式，问题会从格式选择变成输出权力。Markdown是文档逻辑，HTML是界面逻辑。前者默认用户会阅读和编辑，后者默认用户会浏览和操作。

当Agent可以持续生成HTML，它就不只是写文档，而是在生产临时软件。一个深度报告可以变成可交互网页，一个代码审查可以变成风险仪表盘，一个产品规划可以变成带筛选器的路线图。

这会改变企业内部工具链。过去，知识管理系统、BI工具、项目管理软件分别承担文档、数据和任务。

Agent如果直接输出HTML，就可能绕过一部分传统软件界面，把一次性需求变成一次性应用。对企业来说，这很诱人：不用排期，不用立项，不用找前端，直接让Agent把想法变成一个可看的页面。

但这也是风险所在。

HTML输出越像产品，越需要承担产品责任。样式一致性、权限、数据安全、可维护性、可访问性、浏览器兼容、移动端适配，都不是简单格式问题。对于需要审计和长期留存的场景，Markdown仍然是更稳的底座。对于一次性汇报、原型、探索性分析，HTML会明显更有吸引力。

所以，这场争论最可能的结局不是谁淘汰谁，而是分层。

底层记忆、项目规范、代码审查原文继续用Markdown；展示层、决策层、产品原型更多使用HTML；真正成熟的Agent工具会在两者之间自动转换：机器读Markdown，人读HTML，需要审查时回到底层结构，需要沟通时生成界面。

这件事的产业意义在于，AI Agent的竞争不再只是能不能完成任务，而是完成任务后如何让人类接管结果。很多Agent失败，不是因为推理差，而是因为输出让人不想读、不敢改、不能复用。

HTML的价值就在这里：它把Agent的输出从一堆文本变成一种临时产品。

但Markdown不会消失。

越是Agent能力增强，越需要稳定、可追踪、低噪音的中间层。真正高效的工作流不是HTML替代Markdown，而是Agent知道什么时候该写给机器，什么时候该写给人。