你以为在写Markdown文档，其实你在参与AI时代一种新的沟通协议

Markdown 是语义底稿，HTML 是可视化界面，个人知识库正在变成 Agent 的操作系统。

做Claude Code的人在实践中得出了一个判断：Markdown适合承载高信息密度、长篇幅for agent的文档内容，HTML适合承载可读、可视化、for human的交互界面。

然后是Token效率。同样表达"重点"两个字——Markdown用重点，约3个token；HTML用<strong>重点</strong>，约5个token；Word XML用一长串标签，约15+个token。差了五倍。Markdown本身容量小，但富含的信息量大，便于在线上线下上传下传处理，Agent读取和执行都快。

它的价值不在于排版，而在于它足够便宜、足够清楚、足够容易被机器读懂。

我之前也觉得这些和我没关系。但如果你用Obsidian记笔记，用Claude Code写代码，在GitHub上读README——你已经在参与这件事了。

当我把自己第二大脑的系统跟Agent连上的那一刻，发现那些md不仅仅是躺在那封存不动的文档，而是可以被Agent随时调用的记忆系统——还可以不断扩容，带着我们的记忆以Markdown的形式进行判断和执行。

那种感觉太棒了。

Agent的操作指南和记忆系统，最小文件格式就是md。

我从来没想过一个问题：我写的到底是文档，还是协议？

我以为只是自己碰巧走到了这里。后来发现，有人比我走得更早、更远，而且走的几乎是同一条路。

Karpathy——OpenAI创始成员，特斯拉前AI负责人，现在在Anthropic——今年三月在X上发了两条长推，数万赞、1300万浏览。他讲了一件事：用Agent构建第二大脑。做法是直接让LLM读写Markdown文件，raw文件夹是源码，Wiki是编译产物，LLM是编译器（这套编译逻辑我之前那篇文章也拆过）。

我读到的时候，有一种奇怪的熟悉感。

他用的也是Obsidian + Claude Code。我也是。他的Markdown文件也是Agent直接读取、当作行动依据。我的也是。

顺着他的逻辑，甚至可以推到一个更狠的判断：一个研究机构的角色、流程、协作方式，本质上都可以用markdown文件来定义——凡是能被写下来的规则，就可以被持续优化。

我跟K神资料规模当然不是一回事。但方向是一样的。我们都在不知不觉中，把自己的md文件从"笔记"写成了"协议"。

这个方向和Karpathy的实践形成了呼应。但行业走得更远——不只是个人实践，已经开始变成制度了。

AGENTS.md，60,000+项目采用。CLAUDE.md，运行时自动加载。70行Markdown拿下70K+ Star。Karpathy本人一年内立场翻转——去年喊"Markdown取代HTML"，今年说"HTML更好"。

这些信号拼在一起，指向同一件事：文档正在同时承载三种沟通关系。

人→AI

你写AGENTS.md、CLAUDE.md、llms.txt——用Markdown给AI写规则。README.md是给人的产品说明书，AGENTS.md是给AI的入职培训手册。

AI→人

AI执行完，输出HTML界面给你操作——滑块、按钮、Tab、可视化。HTML没有重新赢回文档市场，它赢回的是人类的注意力。Karpathy的立场翻转就是这个变化的表面症状：去年想的是人→AI（Markdown更轻量），今年想的是AI→人（HTML能交互、能操作）。

AI→AI

AGENTS.md让不同Agent共享同一套规则——你的Agent读了AGENTS.md，就知道这个项目里其他Agent会怎么行事。文档变成agent之间的交接协议。

过去文档只有一条线，人写给人看。现在变成三条线，人用Markdown给AI写规则，AI用HTML给人交付界面，AI再通过Markdown、Schema、AGENTS.md、llms.txt这些东西和另一个AI交接上下文。

文档不再只是内容容器，它变成了通信线路。

写到这里，我想再往下走一步。

你打开Word写方案的时候，你想的是"老板会看，客户会看"。你从来没想过一个问题：这个文件写完之后，除了人，还有谁会读它？还有谁和谁会通过它沟通？

我也没有。直到Agent开始直接执行我的md文件，我才意识到——我一直在用"写给人看"的逻辑，写一种"会被AI执行、会被AI传递"的东西。

说明书写完就静止了，协议写完才开始运行。

以前文档写完，是等人来读。现在文档写完，AI可能已经开始跑了。

这不是换工具，是换范式。格式替换只是表面，真正变的是"谁和谁在通过文档沟通"。

那未来会怎样？个人知识库不会只是Markdown，也不会只是HTML。更可能是这样的结构：

Markdown作为记忆和协议——你写的规则、流程、偏好，人和AI都能直接读。

HTML作为界面和表达——AI执行完，给你一个可以操作的页面，不只是文本，而是可以交互的东西。

Schema作为执行层——结构化的规则定义，让AI不只是"读懂"，而是"可执行"。

未来的个人知识库，不只是人的第二大脑，也可能是Agent的第一工作台。你以为你在写笔记，其实你在给未来的AI同事写工作手册。

包括我自己，也是连上Agent之后才意识到的——在那之前，我也觉得Markdown只是一个轻量文档工具。

我自己的工作流里，这条链路已经跑起来了。Markdown是底稿，AI是编译器，HTML是舞台。

现在我写md文件的时候，脑子里已经多了一根弦：这段AI会怎么读？这个指令它会不会误解？我写文档的方式已经变了，只是这个变化太安静，安静到我自己都没注意到。

如果你也想试试，不需要懂代码。你现在写的每一个md文件，人和AI都能直接用。

但有一个实际问题——你写了一个md文件，微信发给同事或朋友，对方打不开。"这是什么格式？"

现在有解了：

·Web端：MD Preview，浏览器打开，拖入文件就能看，不用装任何东西

·iOS App：App Store搜"MD Preview"，微信传的md文件直接打开阅读和编辑

·iOS 26备忘录：系统自带，支持Markdown导入与导出，连第三方App都不用装——苹果在推，不是小众趋势了

·安卓端：搜"MD Reader"，7MB，微信直接导入

当你在微信里传一个.md文件，对方不再需要问"这是什么格式"——Markdown正在从开发者专属变成人人可用。

你现在打开Obsidian，或者GitHub，或者任何一个md文件。仔细看它。

它不只是你的笔记了。

它是你写给AI的指令，是AI写给你的界面，也是AI和AI之间的协议。

你以为在写文档，其实你在参与一种新的沟通协议。