AI时代的内容格式应该是什么？本文探讨Markdown和HTML在AI工作流中的角色分工。

问题的变化

过去讨论Markdown和HTML，更多是在讨论"人怎么写"。Markdown简洁好写，适合程序员；HTML表达力强，适合浏览器。但到了AI Agent时代，这个问题变了。

现在真正重要的不是"人更喜欢写什么"，而是：

• 什么格式更适合AI理解、传递、存储和协作？
• 什么格式更适合最终展示给人看？

结论很明确：Markdown已经成为AI的通用输入输出格式；HTML不适合作为AI的主要输入，但非常适合作为面向人的最终输出。

AI不再只是聊天，而是在"干活"

Claude Code的creator Boris Cherny提到，现在会在手机上同时跑多个Claude Code session，每个session里还有多个agent；晚上甚至会让"几千个"AI coding agents去做更深层的工作。AI coding tool正在从"问答助手"变成"持续工作的自动化劳动力"。

这意味着，AI的输出不再只是"给人看的一段回答"，还可能是：

• 一份计划
• 一个任务拆解
• 一组规则
• 一次工具调用记录
• 一个可继续执行的上下文
• 一份agent下次启动还要读的记忆

这时，格式就变得非常关键。Markdown和HTML的争论，本质上是AI工作流里的协议层和展示层应该如何分工。

为什么Markdown成了AI的"默认语言"

Markdown在AI时代变得更重要，不是因为它最漂亮，而是因为它刚好站在几个平衡点上。

第一，足够接近自然语言

AI读Markdown，不像读HTML那样要跳过大量标签、属性、样式、class、div嵌套。Markdown里的标题、列表、代码块、引用，本质上就是结构化的自然语言，非常适合大模型理解。

第二，足够结构化

纯文本太松散，HTML又太重。Markdown刚好在中间：既可以表达层级，又不会引入过多视觉噪音。对于prompt、system instruction、memory、skill、agent config来说，这种"轻结构"非常合适。

第三，足够通用

现在很多协作和机器人平台都已经支持Markdown或Markdown-like的内容格式。飞书开放平台文档明确提供Markdown组件；微信生态里也大量出现"Markdown→微信可用HTML/富文本"的工具链。Markdown已经不只是程序员写README的格式，而是逐渐变成AI与协作系统之间的中间表达。

第四，已进入Agent的配置和记忆层

Claude Code里的CLAUDE.md，各种coding agent里的AGENTS.md、SKILL.md，再到OpenClaw这类系统里的SOUL.md、MEMORY.md等文件，本质上都在说明一件事：AI的长期上下文越来越多地被沉淀成Markdown文件。

Cloudflare最近推出的"Markdown for Agents"也很说明问题：它允许AI Agent通过Accept: text/markdown请求网页的Markdown版本，Cloudflare会在边缘侧把原始HTML转成Markdown再返回给客户端。这说明一个趋势：Web是给人看的，Markdown正在成为给Agent看的。

HTML适合做"最终交付给人看的输出"

Claude Code团队的Thariq Shihipar提出更偏好让Claude Code输出HTML。这个观点是对的，但要加一个前提：HTML适合做"最终交付给人看的输出"，不适合做"AI长期理解和协作的输入"。

下面这些场景，HTML确实比Markdown好：

• 产品分析报告
• 调研总结
• 项目复盘
• 可视化dashboard
• 技术方案展示
• 一次性生成的小工具页面
• 给老板或团队看的交互式页面

因为这些内容的目标不是让AI再读十遍，而是让人快速理解。HTML可以表达卡片、颜色、布局、图表、交互、折叠区、状态标签、时间线，这些东西Markdown很难表达。

更重要的是，AI写HTML的成本正在下降。如果HTML是AI写的，人只看结果，那HTML的复杂性就被转移给了AI。对于人来说，最终看到的是一个更清晰、更可视化、更容易分享的页面。

HTML为什么不适合作为AI的主要输入？

HTML对人类浏览器友好，但对Agent的上下文管理不够友好。

HTML里有太多和语义无关的东西：样式、class、inline CSS、嵌套div、图标、布局、响应式结构、无障碍属性、脚本引用。它们对页面展示很重要，但对AI理解"这段内容到底在说什么"并不总是重要。

更麻烦的是，HTML不适合人工review。Markdown的diff很清楚，HTML一旦带上布局和样式，diff会迅速变得难以阅读。这对Agent配置尤其致命——AGENTS.md这种文件必须可读、可审计、可版本管理。

再比如memory。Memory的核心价值是长期积累和持续可用，它应该像笔记，而不是像网页。如果memory变成HTML，AI每次读取时都要花额外成本去剥离展示层，并不划算。

所以判断是：HTML是很好的presentation format，但不是好的context format。

Markdown和HTML的正确分工

未来比较合理的模式应该是：Markdown负责AI的理解、协作和持久化；HTML负责人的阅读、展示和传播。

Markdown适合：

• Prompt
• System Instruction
• Agent Skill
• Memory
• 项目说明
• 任务拆解
• 代码文档
• 工具调用说明
• 长期配置文件
• 知识库原始材料

HTML适合：

• 最终报告
• 可视化看板
• 交互式Demo
• 公众号排版
• 汇报页面
• 分享链接
• 产品方案展示
• 面向非技术读者的阅读界面

也就是说，Markdown是AI的工作语言，HTML是人的消费界面。这和软件工程里常见的分层很像：数据层不应该混入UI样式，配置层不应该绑定展示层。

一个好的AI工作流，不应该让模型从一开始就背着HTML干活。更合理的方式是：先用Markdown组织思想、规则、上下文和结构；再在最后一步，把Markdown转成HTML、PPT、公众号富文本、网页或其他人类更容易消费的格式。

最终观点

不赞成简单地说"Markdown过时了"或者"HTML会替代Markdown"。

更准确地说：Markdown在AI时代不是变弱了，而是变成了更底层的通用协议；HTML也不是回到过去，而是成为AI生成的人类展示层。

它们不是竞争关系，而是上下游关系。未来真正高效的AI工作流，大概率不是"只用Markdown"或者"只用HTML"，而是：

用Markdown让AI理解世界，用HTML让人看懂结果。

Markdown是AI的工作台，HTML是AI的橱窗。一个负责思考，一个负责呈现。把这两者分清楚，AI工作流才会真正变得稳定、可维护、可传播。