前段时间在会议室给非技术同事做 AI 应用培训。我只是顺手说了下让 AI 输出内容保持 markdown 语法，然后顺手直接复制一堆带有 # 和 **的内容到飞书，然后一篇排版很好的文档就ok了。
但底下好几双眼睛透着迷茫，似乎不懂为啥 ai 给的内容就直接是排版好了的。
我手从键盘上挪开，突然意识到好像还没给他们讲 markdown 是什么。
我以为理所当然的常识，在别人眼里可能还是未曾接触到的领域。
所以本来没打算聊 Markdown 的，但最近 AI 圈子又兴起了用 agent 来管理知识库，我觉得可以开始聊聊markdown，以后也慢慢分享下自己怎么管理知识的。
像素会议室
你跟 AI 说话，它其实更懂结构
大部分人跟大模型对话，还是像跟人聊天一样——寒暄、铺垫、写小作文。
丢过去一坨几千字的自然语言，AI 回得东拉西扯。好像回复上了你的问题，但总差那么一点，你又说不清差在哪。
image.png
原因很简单。
不是 AI 没读懂你的字，是它没抓到你的结构。你要什么、边界在哪、优先级是什么——这些藏在一坨散文里，它得自己猜。猜对了是运气，猜偏了你还觉得是 AI 的问题。
用 Markdown 写提示词，就是把这些猜测的空间堵死。任务是任务，要求是要求，重点是重点，层级清清楚楚摆在那里。AI 不需要去推断你的意图，直接照着干就行了。
写的时候，脑子反正是清醒的
绝大多数人的日常表达，是一坨黏糊糊的文字，没有主次，没有重点。
Markdown 的 # 和 -，看着是排版符号，其实是在逼你做一件事：把混沌的脑子切出层级来。
Word格式地狱
什么是框架，什么是细节，什么是重点——你不想清楚，符号就没法落下去。写周报是这样，搞方案是这样，跟 AI 写提示词也是这样。
动手之前脑子先过了一遍，写出来的东西自然就不会是一锅粥。
写完之后，排版白送
回到开头那个会议室的场景。
我没做任何额外操作，只是把 AI 返回的内容直接复制进飞书——一篇排版整齐的文档就出来了。
这就是 Markdown 天生带着的东西：# 就是标题，** 就是加粗，- 就是列表。格式藏在符号里，粘到任何支持渲染的地方，排版直接就好了。
不需要调字体，不需要对齐缩进，不需要跟格式刷耗半个下午。
混沌到有序
五分钟够了
不需要看教程。记住这几个符号就能开始干活：
# 一级标题
## 二级标题
**这是加粗**
*这是斜体*
- 无序列表第一项
- 无序列表第二项
1. 有序列表第一项
2. 有序列表第二项
[链接文字](https://example.com)
就这些。
Markdown速查卡
工具的话，飞书和 Notion 原生支持，打开就能写。想折腾的，Obsidian 免费且强大，适合长期知识管理。VS Code 装个 Markdown 插件也行，反正程序员的 IDE 天生就是干这个的。
跟 AI 协作的时候，试试这样写 prompt：
# 任务
帮我写一篇小红书文案，假装我去了趟日本旅游
## 实际情况
- 我哪儿都没去，就在家躺了五天
- 唯一的户外活动是下楼取快递
- 吃了三天泡面一天外卖
## 要求
- 写得像真的去了一样，充满异国风情
- 语气要那种"生活不止眼前的苟且"的感觉
- 配几个假装是在东京拍的文案金句
## 输出格式
用 Markdown 输出
每个金句单独一行，用 **加粗**
段落之间空行分开，方便我直接复制
就算你给到最基础的豆包，你也会发现回复质量直接上一个台阶。
然后反过来，让 AI 把结果用 Markdown 发给你。复制出来的内容，直接开箱即用。
我把投屏线拔掉，端起已经凉了的咖啡。
底下有个同事追过来问我，Obsidian 怎么下载。
走廊追问Obsidian