就是七七最近在整理知识库时，被一个朋友问了个问题：Markdown 语法这么多年没什么变化，大家都在用各种 AI 写作工具和富文本编辑器的年代，你还坚持用 Markdown 做笔记，是不是有点过时了？
这个提问其实很有代表性。作为长期用 Markdown 写技术文档、笔记和个人博客的人，我的答案很明确：Markdown 没有过时，反而是“纯文本 + 结构化”这套思路，在 Obsidian 里活出了新的形态。今天这篇文章就围绕这个话题展开，核心素材来自我自己在 Obsidian 里搭知识库的实践，不会只谈概念，还会把环境准备、语法细节、知识库搭建、常见坑点和工程化使用经验完整分享出来。
如果你对以下内容感兴趣，那就继续看下去：
- 什么是 Markdown，为什么它被质疑“过时”
- Obsidian 到底给 Markdown 补了什么能力
- 一套可以直接复制的个人知识库搭建方案
- Markdown 换行、图片路径、数学公式、主题安装等高频问题的解决思路
文章会以 Obsidian 为实操载体，但 Markdown 本身是通用的，里面的经验换到 Typora、VS Code、语雀等工具照样有参考价值。
1. 背景：Markdown 过时了吗？
1.1 一个来自实际笔记场景的疑问
先说一个我自己遇到的现象。
前两年我一直在用 Word 写方案、用印象笔记存素材、用各种在线文档做协作，结果资料越积越多后，最尴尬的并不是“没地方存”，而是“存了之后再也找不到”：
- 想搜一个之前整理过的技术方案，搜出来一堆不相干的碎片；
- 想从旧笔记里里拷贝一段代码，格式各种错乱；
- 想对一份长期维护的文档做版本历史，发现它被存在某个云盘角落，完全没人更新；
- 最可怕的还是换电脑和换软件，之前整理的目录结构、标签体系全部作废。
后来我把笔记迁移到 Markdown 文件里，配合 Obsidian 来管理，这些问题才慢慢被解决。原因很简单：Markdown 文件是纯文本，数据主权在自己手里；Obsidian 专注于把大量 Markdown 文件组织成一个可以双向跳转的知识网络。
所以说，“Markdown 过时”这个说法，本质上混淆了两件事：Markdown 作为一套轻量标记语言，它确实变化不大；但围绕 Markdown 诞生的知识管理生态，一直在快速进化。Obsidian 就是其中一个典型代表。
1.2 Markdown 没变，但工具生态已经分化
Markdown 的设计初衷是“易读易写”，用极少的标记符号表达标题、列表、链接、代码、引用等基础格式。这套规则足够简单，简单到几乎不可能被替代。
但基础 Markdown 有一个明显的短板：它只解决了“单篇文档怎么写”，没有解决“多篇文档怎么组织”。几十个甚至几千个 .md 文件放在文件夹里时，如果没有关系网络和检索能力，它们就是一座座信息孤岛。
于是工具生态分化出了三个方向：
| 方向 | 代表工具 | 核心思路 |
|---|---|---|
| 专注写作 | Typora、Mark Text、语雀 | 降低写作成本，排版接近 Word |
| 代码协同 | VS Code、Git仓库 | 把 Markdown 当作代码一样管理 |
| 知识管理 | Obsidian、Logseq、思源笔记 | 强调双链、标签、图谱、插件体系 |
Obsidian 属于第三种。它没有把 Markdown 当成简单的排版语言，而是把它当成“个人知识库的节点语言”。你写的每一篇笔记都是一个节点，通过双向链接把节点连成网络。
这也是为什么我今天的答案“藏在 Obsidian 里”——Obsidian 不是让 Markdown 焕然一新的唯一工具，但它是最能体现 Markdown 长期价值的一款工具。
1.3 Obsidian 到底在解决什么问题
Obsidian 是一个基于本地 Markdown 文件的知识管理软件。它有几个关键设计，正好补上了纯 Markdown 的短板：
- 本地优先：所有笔记都是
.md文件，存放在你指定的文件夹（Vault）里。即使 Obsidian 软件以后不更新，文件本身也不会被绑架。 - 双向链接：用
[[笔记名]]就能在当前笔记中链接到另一篇笔记，点一下即可跳转；反过来，被链接的笔记也能自动看到谁在链接它。 - 关系图谱：软件自动把链接关系画成图，帮你发现笔记之间潜在的联系。
- 插件体系：核心插件加上第三方社区插件，支持模板、表格、看板、日历、数学公式增强等几十种能力。
用一句话总结：Obsidian 让 Markdown 从“文件格式”变成了“知识管理基础设施”。这也是我敢于长期依赖它的根本原因。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：在 Obsidian 中建立第一个仓库
2.1 安装 Obsidian
Obsidian 支持 Windows、macOS、Linux、iOS 和 Android。无论哪个平台，最稳妥的方式都是打开官网，从 Download 页面下载对应安装包：
- Windows：下载
.exe安装包，双击运行； - macOS：下载
.dmg，拖入 Applications； - Linux：下载 AppImage，赋予执行权限后直接运行，部分发行版也可以用 Flatpak 或 Snap 安装。
以 Linux 为例，如果拿到的是 Obsidian.AppImage，在终端中可以这样做：
bash复制chmod +x Obsidian.AppImage
./Obsidian.AppImage
如果你的 Linux 发行版有桌面环境，也可以双击 AppImage 直接打开。Obsidian 对系统资源占用不高，日常笔记场景在内存 4GB 左右的机器上也能流畅运行。
版本说明：Obsidian 迭代速度很快，本文以 1.x 当前稳定版为例，不同版本之间菜单名称可能略有差异，但核心概念不变。安装完成后，建议先不急着配置插件，把仓库结构和基础设置搞定。
2.2 仓库（Vault）概念与创建
Obsidian 里最重要的概念是 Vault，中文界面通常叫“仓库”。一个 Vault 就是一个普通的文件夹，里面存放所有笔记和附件文件。
首次启动时，Obsidian 会问你要“创建新仓库”还是“打开本地文件夹”。我建议选“创建新仓库”，给仓库起名为 MyKnowledgeBase。创建完成后，Obsidian 会在文件夹下自动生成一个 .obsidian 目录，专门记录主题、插件和界面设置。
这个设计隐藏着一个关键原则：Obsidian 的配置和你的笔记数据是分开的。.obsidian 目录丢失，不影响笔记文件；笔记文件丢失，配置也没有意义。所以备份时要优先考虑笔记数据，而不是整目录打包。
在 Obsidian 中打开已有 Markdown 文件夹也很简单：选择“打开本地仓库”，定位到存放 .md 文件的文件夹即可。它不会强制你建立新目录，也不会扫描磁盘上其他无关文件。
2.3 常用设置与基础插件
进入 Obsidian 后，建议先调整几个设置项，后面实战会用到：
- 编辑器 → 默认编辑模式：可以选择“实时预览”或“源码模式”。实时预览适合阅读，写作时建议用源码模式，避免样式干扰。
- 文件与链接 → 附件默认存放路径：修改为“仓库根目录下的指定文件夹”，输入
attachments。这样插入图片时，图片会自动保存到统一附件目录，避免散落各处。 - 核心插件 → 模板：打开“模板”插件，并设置模板文件夹路径。
- 核心插件 → 数学表达式：如果需要在笔记中写公式，确保这项开启。
- 核心插件 → 关系图谱：也可以打开，这是 Obsidian 的特色功能之一。
这些都是内置能力，不需要额外安装第三方插件，安全性最高。等基础仓库建立后，再根据需求增加社区插件。
3. 从 Markdown 语法到 Obsidian 扩展
3.1 Markdown 换行与段落规则
很多 Markdown 新手踩的第一个坑就是换行。
在普通文本编辑器里，按一次回车就能开始新的一行。但在 Markdown 里，单次回车在很多渲染引擎中不会生成新的段落，而是被当作同一段落内的软换行。要想真的换行，有两种标准方式：
- 在行尾加两个空格，再按回车；
- 在段落之间插入一个空行。
举个例子，下面这样的源码：
markdown复制第一行
第二行
在大部分 Markdown 渲染器中会显示为：
第一行 第二行
而这样写：
markdown复制第一行
第二行
才会被渲染成两个独立段落。
在 Obsidian 的阅读模式下，单回车会被视为段落分隔，但如果你使用实时预览编辑模式，按 Shift + Enter 也可以实现软换行，然后保存后再看又是另一套效果。建议从一开始就养成“空一行分段”的习惯，这样文件导出到其他平台也不会出现排版异常。
还有一点：Obsidian 默认支持 Markdown 标准语法，所以不管你是用 Typora 写还是用 Obsidian 写，只要遵循标准，文件互换就没有问题。
3.2 数学公式与代码块
Markdown 本身不包含数学公式语法，但它可以通过扩展语法渲染 LaTeX 公式。Obsidian 内部默认支持行内公式和独立公式：
- 行内公式：用一对
$包裹。 - 独立公式：用两对
$包裹。
示例：
markdown复制行内公式 $E = mc^2$
独立公式：
$$
\frac{a}{b} + \sqrt{x^2 + y^2} = z
$$
在 Obsidian 编辑器中，公式会被实时渲染，在阅读模式下也能正常显示。如果你输入后公式没有生效，优先检查两点：
- 是否开启了核心插件“数学表达式”；
- 公式前后
$符号是否配对，是否有多余空格。
代码块在 Markdown 里也属于非常常用的扩展语法。标准写法是在代码块首行写三个反引号，后面跟语言类型：
markdown复制```python
print("hello markdown")
code复制
注意这里的细节：代码块的语言类型不会影响 Markdown 文件本身，它只是让编辑器高亮更加准确。无论你写 Python、Java、Shell 还是 SQL，都可以通过这种方式保存和展示。
### 3.3 图片路径：避免图片变裂图
Markdown 插图和 Word 完全不同。Word 把图片嵌入文档，而 Markdown 只是记录图片路径，渲染时再根据路径读取图片文件。
Obsidian 默认推荐它的 Wiki 风格图片语法：
```markdown
![[图片名称.png]]
但它也支持标准的 Markdown 图片语法：
markdown复制
两种方式各有优劣：
![[...]]形式更简洁，Obsidian 会自动补全文件名，但只有 Obsidian 语境下最顺手；形式更通用，导出到其他 Markdown 工具时兼容性更好。
如果你希望笔记未来不被 Obsidian 绑定，建议在“文件与链接”设置中把“新附件默认格式”选为 Markdown 相对路径，并把附件统一存储到 attachments 文件夹。这样当你移动整个仓库时，只要相对路径不变，图片就不会裂。
实际项目中我最常用的经验是：图片文件名尽量不要写中文且不要包含空格，例如 20250101-architecture.png；而笔记和图片都放在同一个仓库内，不做跨仓库引用。
3.4 双向链接和标签：Obsidian 给 Markdown 加的新“语法”
Obsidian 最有名的能力就是双向链接。你可以在任意笔记中输入：
markdown复制[[编程笔记 MOC]]
Obsidian 会自动把它转成指向目标笔记的链接。阅读模式下点击链接可以跳转，目标笔记页面也会自动生成“反向链接”区域，显示哪些笔记引用了它。
这带给知识管理一个质变：你不再需要记住文件放在哪个文件夹，而只需要记住“当前内容和哪篇笔记有关”。
标签也是 Obsidian 中非常常用的组织方式。在正文中直接输入 #标签 就能创建一个标签，例如：
markdown复制这是一条关于 #Obsidian 的笔记
但要注意，#标签 和 Markdown 的标题语法 # 标题 是两回事。标题语法中 # 后必须有空格，而标签语法中 # 后紧跟标签文本，不加空格、通常也不含中文空格或斜杠。
除了正文标签，更推荐在笔记的 Frontmatter（前置元数据）中声明标签：
yaml复制---
tags:
- 知识管理
- Obsidian
---
Frontmatter 是 YAML 格式的元数据区，放在 Markdown 文件开头，用两个三横线包围。Obsidian 会根据它自动把笔记归类，也方便用属性筛选。
3.5 Typora 与 Obsidian 怎么选
这是另一个高频问题。简单对比：
- Typora 是纯写作工具，所见即所得，适合写文章、博客草稿、会议记录。
- Obsidian 是知识管理工具，适合建立长期学习库、项目文档库和个人知识网络。
如果你只是想快速把 Markdown 文件排版得像 Word，Typora 更轻；如果你想长期沉淀知识、让笔记之间产生联系，Obsidian 更适合。二者可以共存：我用 Obsidian 管知识库，用 Typora 写最终要发布的长文，因为 Typora 的导出排版更精细。
4. 实战：用 Obsidian 搭建个人知识库
4.1 需求分析与目录规划
一个知识库如果没有目录规划，时间久了就是垃圾场。这里推荐比较通用的 PARA 方法，也就是把笔记分成四类：
- Projects：有明确目标、有截止时间的项目；
- Areas：需要长期维护的领域，比如“编程”“阅读”“健康”；
- Resources：主题资源和参考资料；
- Archive：已结束项目、已完成内容、暂时不用的旧笔记。
在此基础上，可以增加收集箱（INBOX）和元信息目录（Meta）。我实际使用的目录如下：
text复制MyKnowledgeBase/
├── 00-INBOX/ # 快速收集，未整理笔记
├── 10-Projects/ # 有明确目标的项目资料
├── 20-Areas/ # 长期维护的领域
├── 30-Resources/ # 主题资源库
├── 40-Archive/ # 归档
├── 90-Meta/ # 模板、首页、设置说明
└── attachments/ # 所有附件图片
这个结构的好处是：新笔记先进 00-INBOX，整理后移动到对应目录，不会因为分类而打断记录过程。先快速记录，再定期归档，是知识库能坚持维护下去的关键。
4.2 建立首页 MOC 与模板
MOC（Map of Content，内容地图）是 Obsidian 知识库的重要路由页。它本质上就是一篇文章，里面放满链接，用来导航。
在 90-Meta 下新建 首页.md，内容如下：
markdown复制---
type: MOC
created: 2025-01-01
updated: 2025-01-01
tags:
- 知识库首页
---
# 知识库首页
## 待整理
- [ ] 本周收集箱中的笔记需要归档
- [ ] 更新 `编程笔记 MOC`
## 主题索引
- [[编程笔记 MOC]]
- [[阅读笔记 MOC]]
- [[项目管理 MOC]]
以后每新开一个重要主题，就在 90-Meta 下建立一个对应的 MOC 笔记，并在首页放上链接。这样打开 Obsidian 后，我永远只有一个入口，不会迷失在几百个文件里。
接着配置模板。在 90-Meta/Templates 目录下创建 默认笔记模板.md：
markdown复制---
type: 笔记
created: {{date}}
updated: {{date}}
tags:
- 待整理
source:
---
# 标题
## 为什么记这条笔记
## 核心内容
## 我的理解
## 下一步行动
Obsidian 的核心模板插件支持 {{date}} 变量。在设置中把模板文件夹指定为 90-Meta/Templates，新建笔记时点击“模板”按钮即可插入。
4.3 记录第一篇笔记
现在做一次完整操作。
在 00-INBOX 中新建一篇笔记，命名为 阅读笔记-Eleven.md，内容如下：
markdown复制---
type: 读书笔记
created: 2025-01-06
updated: 2025-01-06
tags:
- 阅读
- 效率
source: 《Eleven》
---
# 阅读笔记-Eleven
## 核心观点
这是一本关于写作的书籍，核心观点是写作质量取决于素材组织能力。
## 关键摘录
> 写作不是从空白开始，而是从素材重组开始。
## 数学公式示例
信噪比公式：
$$
SNR = \frac{P_{signal}}{P_{noise}}
$$
## 我的理解
素材管理是知识管理的前置动作，Markdown 正好适合作为素材存储格式。
## 下一步行动
- [ ] 整理书中提到的素材管理方法
- [ ] 关联到 [[写作系统 MOC]]
在写作过程中，你会用到标题、引用、代码块、数学公式、任务列表和双向链接，正好覆盖前面讲到的核心语法。
4.4 运行与验证
写完笔记后做几个验证：
- 点击
[[写作系统 MOC]]，Obsidian 会提示创建新笔记或跳转到已有笔记，说明双向链接生效； - 打开右侧“关系图谱”，你能看到阅读笔记和写作系统 MOC 两个节点之间的连线；
- 在搜索中输入
阅读，能按文件名和标签定位笔记； - 把
阅读笔记-Eleven.md移动到30-Resources目录，双向链接不会失效，因为 Obsidian 记录的是笔记名称，而不是绝对路径。
这是 Obsidian 与普通 Markdown 编辑器最明显的差异：链接关系是“笔记名称”层面的，跟文件物理位置解耦。你移动文件后，不需要手动修改其他笔记里的链接。
4.5 导出为 Word 等成果物
虽然知识库长期沉淀在 Markdown 里，但有些场景需要交付成 Word 或 PDF。最常用的工具是 Pandoc。
Linux 下安装 Pandoc 示例：
bash复制sudo apt install pandoc
转换示例：
bash复制pandoc 阅读笔记-Eleven.md -o 阅读笔记-Eleven.docx --toc -V lang=zh-CN
这条命令把 Markdown 转换为带目录的 Word 文档。Pandoc 对标准 Markdown 支持很好，所以我在前面建议尽量用标准语法，少用 Obsidian 专属扩展语法，就是因为导出时能少踩很多坑。
如果你是 Obsidian 用户，也可以使用核心插件“导出”，或者安装社区插件进行 PDF/DOCX 导出。具体名称不同版本变化较快，这里不写死插件名，重点是把原始 Markdown 内容维护好，转换工具随时可以换。如果你更习惯通过 Coze 这类自动化工作流来处理文档转换，本质上也绕不开“本地 Markdown 先保持结构规范”这个前提。
5. 常见问题与排查思路
5.1 高频问题清单
| 问题现象 | 常见原因 | 解决思路 |
|---|---|---|
| Obsidian 安装主题 AnuPpuccin 时提示无法安装 | 网络问题、主题仓库信息未刷新、主题目录权限异常 | 手动下载主题包并放入 .obsidian/themes 目录 |
| 插件市场打不开或一直转圈 | 第三方插件源网络不稳定 | 使用社区镜像源或手动下载插件安装 |
| 图片移动到其他电脑后丢失 | 附件没有统一存放，或链接是绝对路径 | 设置统一附件目录，使用相对路径 |
| Markdown 中按回车后不能换行 | 单回车在 Markdown 中只是软换行 | 在段落之间加空行，或行尾加两个空格 |
| 数学公式显示为源代码 | 没有开启数学表达式核心插件 | 设置中开启“数学表达式” |
| 从 Typora 复制笔记到 Obsidian 后图片失效 | 路径格式和附件存储方式不一致 | 把附件放到同一个仓库，并用 wiki 或相对路径重新插入 |
| 移动笔记后双向链接失效 | 链接用了旧文件名 | 重命名时需要同时更新引用；建议用 Obsidian 内置重命名功能 |
5.2 重点排查：主题安装失败、插件市场打不开、附件路径失效
主题 AnuPpuccin 无法安装，在 Obsidian 用户里很常见。点击“主题商店”中的“安装”后，如果长时间显示正在下载，或者弹出“校验失败”，通常不是因为主题本身有问题，而是 Obsidian 主题仓库源不稳定。
解决步骤：
- 先检查是否开启了代理设置（如果需要的话），关闭后重试；
- 在主题商店页面多刷新几次；
- 如果仍然失败，直接采取最稳妥的方案：从 GitHub 主题仓库下载
theme.css文件，然后在 Obsidian 的.obsidian/themes目录下新建文件夹AnuPpuccin，把 CSS 文件放进去，再回到设置中选择主题。
插件市场打不开的原理和主题差不多。建议先确定插件官方仓库是不是有更新，再决定是否手动安装。手动安装时到 .obsidian/plugins 目录，创建插件文件夹，把 main.js、manifest.json 等文件放进去，然后在 Obsidian 中重新加载插件。
附件路径失效的问题，通常发生在“从别人那里拿来一个仓库”或“自己移动文件夹”的时候。解决方法是统一使用相对路径，保证 .md 文件和 attachments 目录在同一个仓库根下。Obsidian 也提供了“修复链接”（比如搜索替换图片路径）的第三方插件，但最根本的还是从一开始就把附件路径规范起来。
6. 最佳实践：把 Markdown 当代码管理
6.1 文件命名与目录规范
Obsidian 允许文件名含空格和中文，但为了长期可维护，我建议遵循以下规则：
- 文件名尽量短，先写主题关键词，再写类型，例如
阅读笔记-Eleven.md； - 避免文件名中出现
/、\、#、[、]这类在链接或路径中容易产生歧义的字符； - 同一知识库内不要出现重名笔记；如果必须重名，要显式指定链接的目标路径；
- 目录编号可以按
00、10、20这样的方式，让文件夹顺序稳定，不会因为字母排序混乱。
6.2 Frontmatter 与标签规范
Frontmatter 是 Markdown 文件中的 YAML 元数据区，我把它视为“笔记的 Schema”。建议至少维护这几个字段：
yaml复制---
title: 阅读笔记-Eleven
created: 2025-01-06
updated: 2025-01-06
status: 进行中
source:
tags:
- 阅读
---
这里面有两个细节很重要：
created和updated不要靠手写，尽量用模板插件自动生成，否则以后很难做时间维度的筛选；tags字段放在 Frontmatter 里，比正文中打散标签更容易统计和过滤。正文中的#标签适合快速临时标记，Frontmatter 中的tags适合形成长期稳定的分类体系。
如果发现标签体系越来越乱，可以考虑引入“标签命名空间”，比如用 领域/编程、领域/产品 这种方式，让标签呈现层级关系。但不要过度分层，三级以内足够。
6.3 双向链接不要滥用
双向链接虽然强大，但有代价。链接越多，知识网络越复杂，后期维护成本越高。这里有一条经验：新笔记加入知识库时，至少关联一个 MOC 或父级概念，但不要为了“显得有关系”而乱加链接。
一个合理的链接策略是：
- 笔记内容要能和另一篇笔记真正产生“引用、对比、依赖”关系；
- 新笔记尽量先链到 MOC 路由页，而不是链到几十篇具体笔记；
- 定期检查反向链接区，发现多篇笔记反复引用同一概念时，考虑提取一个 MOC 或专有名词页。
可以用 Obsidian 的“未链接文件”功能检查哪些笔记完全孤立。真正孤立的笔记要么是暂时还没发展起来，要么就应该考虑删除或合并。
6.4 同步与备份策略
本地优先带来一个风险：只能在本机访问。所以同步和备份必须提前规划。
比较稳妥的组合是：
- 主数据目录放在本机；
- 使用坚果云、OneDrive、iCloud 等网盘同步整个 Vault 文件夹；
- 对重要仓库，额外用 Git 仓库管理版本历史；
- 移动端和桌面端不要同时剧烈编辑同一篇笔记，否则可能出现同步冲突。
用 Git 管理 Obsidian 仓库时，建议先确认 .obsidian 目录下的配置文件是否需要纳入版本控制。有些插件配置含有本机路径，协作时可能制造冲突。最简单的做法是把核心笔记加入 Git，把 .obsidian/workspace.json 这类临时状态文件忽略掉。
如果环境允许，还可以建立一个定时脚本，把笔记目录打包备份。备份频率取决于笔记更新频率，至少每周一次。备份的价值只有在灾难恢复时才会被意识到，但那时候后悔往往已经来不及了。
7. 最终回答：Markdown 没有过时，Obsidian 让它变得能打
回到标题里的问题：Markdown 过时了吗？
我的答案是：没有。Markdown 之所以看起来“十年没变”，恰恰说明它是成熟稳定的基础设施。真正过时的不是 Markdown，而是“用一堆乱七八糟的富文本软件管理知识”的做法。Obsidian 则用一个工程师很熟悉的思路给了 Markdown 第二春：用纯文本保存数据，用双向链接建立关系，用插件扩展能力，用本地文件保证长期主权。
文章写到这里，核心内容已经完整：从 Markdown 语法细节到 Obsidian 环境准备，从知识库实战到常见问题，从最佳实践到最终结论。如果你能亲手在 Obsidian 里搭一个最简单的知识库，用 [[链接]] 把两篇笔记连起来，再用模板插件稳定维护 30 天，就一定能够理解我在说什么。
Markdown 没有过时，它只是等来了更适合它的工具生态。而 Obsidian 是目前我用下来，最值得长期投入的一个答案。如果你也有自己的笔记组织心得，欢迎在评论区分享你的知识库目录结构或踩坑经验，互相参考。