Obsidian 简介
Obsidian 是一款基于本地 Markdown 文件的双链笔记软件，官方将其定位为你的第二大脑（A second brain, for you, forever）。，它能帮你把零散的知识点编织成一张可生长的知识网络。
Obsidian 是一款本地优先的个人知识管理工具。
Obsidian的核心文件格式是纯文本 Markdown，所有笔记都以 .md 文件的形式存储在电脑本地文件夹中。
与 Notion、语雀这类在线笔记工具不同，Obsidian 不需要联网，你的数据完全掌握在自己手里。
与 Roam Research、Logseq 这类大纲型笔记相比，Obsidian 更接近传统文档编辑体验，自由书写的同时保留了强大的双向链接能力。
Obsidian 之于笔记，就像 VS Code 之于代码编辑，不是一个封闭的平台，而是一个可以无限扩展的工具，而你的所有内容都存储为纯文本文件，你永远拥有它们。
为什么选择 Obsidian
| 特性 | Obsidian | Notion | Roam Research |
|---|---|---|---|
| 存储方式 | 本地 Markdown 文件 | 云端数据库 | 云端数据库 |
| 离线可用 | 完全离线 | 需预先加载 | 需联网 |
| 双链能力 | 原生支持 | 有限支持 | 原生支持（大纲式） |
| 扩展性 | 1000+ 社区插件 | 少量集成 | 较少插件 |
| 价格 | 个人免费 | 免费增值 | 付费订阅 |
| 数据迁移 | 复制文件夹即可 | 需导出 | 需导出 |
Obsidian 的核心本质只有三点：
- 纯文本存储：所有笔记都是 .md 格式的 Markdown 文件，存放在你本地电脑的某个文件夹里。没有专有格式，没有数据库，用任何文本编辑器都能打开。
- 双向链接：笔记之间可以相互引用，形成一张知识网络，而不是孤立的文件。
- 可扩展性：拥有超过 1500 个社区插件，可以把 Obsidian 改造成任何你需要的形状。
为什么开发者特别适合用 Obsidian
很多工具都能「记笔记」，但 Obsidian 对开发者来说有几个独特的吸引力。
Markdown 是你的母语
作为开发者，你每天都在写 README、文档、注释。
Markdown 本就是你工作的一部分。Obsidian 以 Markdown 为第一公民，没有学习成本。
本地文件等于 Git 友好
所有文件都是纯文本，这意味着：
- 可以用 git init 对整个笔记库做版本控制
- 可以用 grep、sed、脚本批量处理笔记
- 迁移、备份、导出无任何障碍
- 你的数据永远不会被某家公司的倒闭而带走
程序员思维与 Obsidian 高度契合
| 开发者习惯 | Obsidian 对应功能 |
|---|---|
| 函数/模块之间相互引用 | 双向链接 [[]] |
| 为代码写注释和文档 | 笔记内嵌代码块 |
| 用 Git 追踪变更 | 纯文本 + Git 版本管理 |
| 用标签/分支管理任务 | 标签系统 + 文件夹结构 |
| 查阅 API 文档 | 个人知识库 + 快速搜索 |
| 项目 README | 项目笔记 + Canvas 白板 |
与主流工具的核心差异
在选择工具之前，你需要清楚各自的定位，避免重复建设。
Obsidian vs Notion
| 对比维度 | Obsidian | Notion |
|---|---|---|
| 数据存储 | 本地纯文本文件 | Notion 服务器（云端） |
| 离线可用 | 完全离线 | 需要网络 |
| 数据所有权 | 你完全拥有 | Notion 公司托管 |
| 速度 | 极快，毫秒级响应 | 依赖网速，偶有卡顿 |
| 协作功能 | 弱（需要第三方工具） | 强（天然支持多人协作） |
| 自定义程度 | 极高（插件生态丰富） | 中等 |
| 适合场景 | 个人知识管理、深度思考 | 团队协作、项目管理 |
| 学习曲线 | 中等 | 低 |
结论：如果你需要和团队协作，Notion 更合适。如果你需要建立个人的、长期的知识体系，Obsidian 是更好的选择。
两者并不互斥，很多人同时使用。
Obsidian vs Roam Research
Roam Research 是双向链接笔记的先驱，但 Obsidian 是更实用的选择：
- Roam 是 SaaS 订阅制（每月 $15），Obsidian 个人使用完全免费
- Roam 数据存在云端，Obsidian 数据在本地
- Roam 的大纲式结构更适合思维发散，Obsidian 的文档式结构更适合沉淀整理
Obsidian vs Typora / VS Code
这些工具也能写 Markdown，但它们缺少 Obsidian 的核心能力：
- 没有双向链接：文件之间是孤立的，无法形成知识网络
- 没有图谱视图：无法可视化地看到知识之间的关联
- 没有插件生态：无法按需扩展功能
Typora 是优秀的 Markdown 编辑器，VS Code 是优秀的代码编辑器，但它们都不是知识管理工具。
Obsidian 的核心理念
在安装之前，先建立几个基本的心智模型，会让后续的学习事半功倍。
理念一：笔记即文件
Obsidian 没有自己的数据库或私有格式。
每一篇笔记就是你硬盘上的一个 .md 文件。
~/Documents/MyVault/
├── 日记/
│ ├── 2024-01-15.md
│ └── 2024-01-16.md
├── 技术笔记/
│ ├── Git 常用命令.md
│ └── Docker 入门.md
└── 读书笔记/
└── 深入理解计算机系统.md
当你在 Obsidian 中创建一篇笔记，实际上就是在某个文件夹中创建了一个 Markdown 文件。
你可以在资源管理器中直接看到它，用 cat 命令读取它，用 Git 追踪它。
理念二：链接比文件夹更重要
传统的笔记软件依赖文件夹来组织内容，就像把书放进不同的抽屉。
这种方式有一个致命的缺点：一个知识点只能属于一个抽屉。
Obsidian 的核心思想是：与其把笔记放进分类，不如把笔记连接起来。
# Docker 入门 Docker 是一种容器化技术，与 [[虚拟机]] 的关键区别在于... 在部署时，通常配合 [[Kubernetes]] 使用... 学习 Docker 之前建议先了解 [[Linux 基础]]...
当你打开「Docker 入门」这篇笔记时，你会看到它链接到了「虚拟机」「Kubernetes」「Linux 基础」三篇笔记。
同时，「Linux 基础」这篇笔记也会显示「有一篇叫 Docker 入门的笔记引用了我」。
这就是双向链接，它模拟了人类大脑中概念之间的关联方式。
理念三：知识图谱是果，不是因
很多初学者看到 Obsidian 漂亮的知识图谱，误以为「搭建知识图谱」是使用 Obsidian 的目的。
然后花大量时间设计结构，却没有真正记笔记。
正确的理解是：图谱是你记笔记、建立链接之后自然生长出来的副产品，而不是你一开始就要精心设计的东西。
先记笔记，先建链接，图谱自然会变得丰富。
理念四：永远不要追求完美系统
这是新手最容易掉入的陷阱：花太多时间设计「完美」的文件夹结构、标签体系，而不是真正地记录和思考。
一个「足够好」且持续使用的系统，远胜于一个「完美」但从未真正落地的系统。