Markdown为何是AI世界的母语?Obsidian语法保姆级教程

系统梳理Markdown核心语法与Obsidian扩展语法,并解释其成为AI通用输出格式的底层逻辑。
本文整理自Obsidian公开课,围绕Markdown的核心价值与实操语法展开。Markdown是一种诞生于2004年的轻量级标记语言,用极少的符号同时完成写作与排版,让创作者保持心流而不被格式操作打断。文章将常用语法分为文档结构、文字格式、列表任务、链接媒体、数据代码五大类逐一拆解,并介绍了Obsidian独有的双链、标签、Callout等扩展语法。在此基础上,文章进一步解释了Markdown成为ChatGPT、DeepSeek等AI工具默认输出格式的两大原因:它是"结构化的纯文本",能同时标注内容层级与样式;同时几乎无冗余数据,可节省token消耗与推理成本。最后点明Markdown结构与样式分离的设计哲学,是其兼容性与长期价值的根本来源。
在AI时代,几乎所有的对话工具——ChatGPT、豆包、DeepSeek——给你的回复都遵循同一种格式规范。这背后的答案就是 Markdown。这篇内容整理自「清单控沙牛」的Obsidian公开课,系统梳理了Markdown的核心语法、Obsidian的扩展语法,以及一个更深层的问题:为什么Markdown会成为AI世界的通用语言。
什么是Markdown:20分钟学会、受益终身的技能
很多人一听到"语法"两个字就犯怵,觉得是高深的东西。但Markdown恰恰是学习成本最低、性价比最高的一种语法,没有之一。它本质上是一种轻量级标记语言,你只需要在文本中插入几个简单符号,就能定义内容的结构和样式。
Markdown诞生于2004年,可以算是一种"上古时期"的语言,它的设计初衷就是"易读易写"。它最大的价值在于解决了传统写作工具的痛点。
回想在Word中写作的过程:写一段文字,要去菜单栏点"标题1",写到重点又要去点"加粗"或按Ctrl+B。这意味着码字和排版是完全分离的——你专注的写作流程不断被排版这种小事打断。而Markdown让你在敲字的过程中顺手用几个符号完成排版,从而保持连贯,更容易进入写作的心流状态。
正因为所有Markdown文件都是纯文本、没有多余格式,它拥有极强的兼容性。Typora、Bear、Ulysses,甚至一个普通记事本工具都能打开和编辑Markdown笔记,而不仅限于Obsidian。
Markdown由John Gruber与Aaron Swartz共同设计,其名称本身就是对HTML(HyperText Markup Language)的一种戏谑对照——"Markdown"意指更简化、更轻量的标记方式。文件通常以.md或.markdown为扩展名存储,本质是纯文本文件,无需任何专用程序即可阅读。Markdown语法经由解析器渲染后,可以转换为HTML、PDF等多种格式输出,这也是它能在GitHub代码托管、Reddit社区、Notion笔记、技术文档等截然不同的场景中广泛通用的根本原因。值得一提的是,由于各平台在通用语法之外各自增加了扩展,市面上出现了多个"方言版本"(如GitHub Flavored Markdown、CommonMark等),核心语法高度一致,扩展部分略有差异。
六大类通用Markdown语法实操
沙牛将常用的Markdown语法分为六个类别,下面逐一拆解。这些语法在任何Markdown编辑器中基本都通用。
文档结构类
标题:输入一个井号加空格就是一级标题,两个井号是二级标题,以此类推最多支持六级。多数笔记只会用到一到三级。Obsidian右侧边栏的"大纲"面板会根据标题自动生成可折叠的目录。
分割线:三个减号即可生成一条分割线,用于隔开不相关的内容区域。
引用:一个大于号加空格,用于引用名人名言或他人观点,引用内可回车换行,连按两次回车退出引用格式。

文字格式类
加粗用左右各两个星号包裹文本(或选中后按Ctrl+B);左右各一个星号是斜体;各三个星号是粗斜体;删除线用左右各两个波浪线。
行内代码用一对反引号包裹,比如标注工具名、命令名时非常实用。需要注意,选中文本按反引号时输入法必须处于英文状态,否则文本会被直接替换。
列表与任务
无序列表用一个星号(或减号)加空格;有序列表用"1."加空格自动编号。两者都可以通过 Tab 缩进、Shift+Tab 升级来控制层级,并支持折叠展开。沙牛的课时文档正是用这种"清单笔记"的方式组织的。
待办事项列表的原始语法较复杂——减号、空格、中括号、中括号内空格,任何一个空格缺失都会失效。推荐直接用快捷键 Ctrl+L(macOS 为 Command+L)创建,完成后点击方框打勾即可,对应中括号内的空格会自动变成 X。

链接与媒体
链接语法由中括号(链接文本)和小括号(网址)两部分组成,推荐用 Ctrl+K 快捷键自动生成。插入图片通常无需手写语法,直接把资料库中的图片拖进笔记即可自动生成图片语法。
数据与代码
表格是Markdown中字符最多的语法,手写很繁琐。在Obsidian中用命令面板(Ctrl+P)搜索"插入表格/Insert Table"即可生成,并支持鼠标拖动调整行列——这是Obsidian最易用的表格编辑器之一。
代码块用三个反引号创建,可在后面标注语言(如 python、txt、markdown)。右上角会显示语言并支持一键复制,非常适合保存常用的AI提示词。

代码块还是一种强大的扩展入口。比如流程图并不是图片,而是 Mermaid 语法——指定代码块语言为 mermaid,即可绘制流程图、甘特图、思维导图等。现在完全可以让AI帮你生成这些语法。

Mermaid是一种基于文本的图表绘制语言,由Knut Sveidqvist于2014年创建,其设计理念与Markdown高度一致:用简洁的文本描述替代拖拽式的图形操作。在Mermaid代码块中,你可以用十余行文字描述一个包含判断分支的流程图,渲染器会自动计算节点位置与连线。Obsidian原生支持Mermaid渲染,常见的图表类型包括:flowchart(流程图)、sequenceDiagram(时序图)、gantt(甘特图)和mindmap(思维导图)。由于手写Mermaid语法有一定门槛,实践中最高效的方式是向AI描述你想要的图表结构,让AI直接生成代码块后粘贴进笔记——这也是Markdown与AI协作的典型应用场景之一。
Obsidian的专属扩展语法
除了通用语法,Obsidian还有一些自己特有的扩展语法:
- 双链:输入两个中括号即可选择资料库中的其他笔记建立双向链接,这是下一课时的重点内容。
- 标签:井号后面不加空格直接跟标签名。与多数笔记工具不同,Obsidian的标签不仅能标注整篇笔记,还能标注每一个标题、每一个段落。
- 标注(Callout):手写较麻烦,建议用命令面板"插入标注/Insert Callout"。可以设置 note、tip、warning、success 等类型,在中括号后加号或减号可以让标注默认展开或折叠。
- 属性(Properties):用于给笔记添加元数据,也是后续课时的内容。
为什么说Markdown是AI世界的母语
观察任何AI工具的回复——ChatGPT、豆包、DeepSeek——你会发现它们输出的加粗、代码块、标题全都是Markdown语法。原因有三层:
结构化的纯文本。AI不可能每次回复都发一个Word文档,它需要的是纯文本,同时又要标注出哪里是标题、哪里是重点、哪里是代码块。Markdown恰好是"结构化的纯文本",既能定义结构,又能定义样式,输入和输出都容易编写与阅读。
低冗余。Markdown文件中除了几个符号几乎没有多余数据。相比之下,Word、HTML、PDF这类文件把格式隐藏在文件内部,AI读取时要先剔除大量冗余数据,这不仅多花token、增加成本,速度也会变慢。低冗余是Markdown成为AI通用格式的关键理由。
能同时满足这两点特性的格式,除了Markdown别无他选,这正是它被称为"AI世界母语"的根本原因。
Token是大语言模型处理文本的基本计量单位,可以粗略理解为"词片段"——一个汉字通常对应1至2个token,一个英文单词约为1个token。模型的输入与输出都按token计费,上下文窗口(即模型一次能"看到"的最大文本量)也以token为上限。当文件格式本身携带大量冗余标记时(例如Word的XML结构或HTML的标签嵌套),这些无意义的符号会占用宝贵的token配额,既推高使用成本,也压缩了可用于实际内容的空间。Markdown的低冗余特性意味着同样的信息密度只需消耗更少的token,这在处理长篇文档或多轮对话时优势尤为显著。
两个容易被忽略的关键点
段落之间一定要空一行。这既是更规范的Markdown格式,也更利于阅读。这是新手最容易忽略的细节。
理解结构与样式的分离。Markdown符号定义的是笔记的"结构"(哪里是标题、引用、代码块),而这些结构长什么样则由"样式"决定。同样的结构,换上不同的样式(在Obsidian中即"主题")就会呈现完全不同的面貌。主题的核心是一个扩展名为 .css 的样式表文件,普通用户无需修改代码,只要在"外观"设置里切换主题、微调字体即可。
这种结构与样式的分离,让你的笔记内容与呈现方式解耦,是Markdown又一个被低估的优势。
小结
Markdown的全部常用语法,十来分钟就能掌握,真正做到"有手就行"。它用最简单的符号实现了写作与排版的统一,兼具结构化、纯文本、低冗余三大特性,因而成为AI时代最通用的信息载体。对于任何想认真做知识管理、或频繁与AI协作的人来说,这都是一项值得优先投入的基础技能。
相关推荐

本地部署私人DeepSeek全攻略:联网+知识库+隐私安全
手把手教你用Ollama、Chatbox、AnythingLLM搭建纯本地、可联网、带知识库的私人DeepSeek。涵盖蒸馏版模型选择、RAG知识库原理与API调用,隐私安全零门槛部署全流程干货。

AI Agent开发四阶段学习路线:从入门到企业级实战
AI Agent开发零基础学习路线全解析:从核心概念、ReAct范式,到多智能体协作、Prompt调优与企业级实战项目,系统掌握规划、记忆、工具调用、RAG与MCP,帮你少走弯路成为AI核心人才。

DeepSeek Harness 新玩法:Agent 监督 Agent 的自进化实验
一位 B 站 UP 主基于 DeepSeek Harness 实现「Agent 监督 Agent」的自进化实验:用官方原版 DSH 作稳定监督者,驱动自研 Agent 完成任务并自动修复 bug,配合台账机制和 CDP、Chrome DevTools MCP 实现近乎无人值守的软件迭代。