Obsidian 上手指南——从建库到长期可用

如果你也经历过这些：在 Notion 里精心搭了一堆数据库，半年后自己都找不到东西；换笔记软件时发现导出全是乱码；某天服务挂了，几年的记录打不开——那 Obsidian 值得看下去。

它的核心卖点只有一句话：库就是你硬盘上的一个文件夹，里面全是纯文本 .md。这句话决定了它其余全部特性：离线可用、不被锁定、任何编辑器都能打开。

本文功能与价格信息核对到 Obsidian 1.14.4（2026-10-05 公开发布）。版本迭代较快，具体以官方更新日志为准。

本地优先到底意味着什么

市面上笔记软件的分歧，本质是数据放谁家。Obsidian 选了另一条路，并且靠”不卖数据”来证明自己：

离线可用：没网照样写，不转圈
不锁数据：就算哪天 Obsidian 公司消失，笔记一个不丢
不上报遥测：官方声明不做用户数据买卖
商业模式透明：靠 Sync / Publish 这类可选服务赚钱，而不是卖注意力

它真正的差异化能力只有三个，其他软件要么没有，要么实现方式不同：

能力	Obsidian 的做法	竞品通常怎么做
双向链接	输入 `[[` 链接另一篇，被链接方自动记录”谁引用了我”	Notion 需通过数据库关联维护关系，多数笔记软件无此概念
图谱 / Canvas	把笔记关系可视化，或在无限白板上摆卡片	少数软件有图谱，白板多为独立产品
数据库化（Bases）	用 YAML 属性把笔记变成可筛选、可排序的表格或看板	Notion 有，但数据在云端

适合：需要长期积累且要求可溯源的人（研究者、学生、写作者）、想把文档放进 Git 管理的工程师、介意数据落在别人服务器上的知识工作者。

不适合：需要多人实时协同编辑同一页的（请用飞书/腾讯文档/Notion）、想要开箱即用零配置的、只记零散便签的（系统备忘录更快）。

核心心智模型：库、文件、链接

新手最容易犯的错，是拿文件夹思维去用 Obsidian。先建立这套模型，后面所有操作都顺了。

库（Vault）

一个库就是一个文件夹。可以建多个（工作/个人/阅读），但初期只建一个——多库会把链接和图谱割裂成几座孤岛。

我的知识库/                  ← 这就是一个 Vault
├── .obsidian/              ← 配置与插件（别手改）
├── 00-Inbox/               ← 收集箱
├── 10-Projects/            ← 项目
├── 20-Areas/               ← 领域
├── 30-Resources/           ← 资源
├── 40-Archive/             ← 归档
├── 90-Templates/           ← 模板
├── attachments/            ← 附件
└── 首页.md

.obsidian/ 里存着配置、主题、插件设置，其中 workspace.json 记录着窗口布局。手动改它大概率会导致布局错乱，需要重置时用命令面板的”恢复默认布局”更稳。

三条铁律

链接优先于文件夹。笔记放哪个文件夹只决定物理位置，它真正的位置由链接决定。新建笔记时至少链到 1～3 篇已有笔记，否则它很快就会消失在文件列表里。
文件夹只做粗分类。层级不超过 3 层，细分交给标签和属性——它们随时能改，而移动文件会打断链接习惯。
一页一概念。别把十个主题塞进一篇长文，原子化笔记才能被复用和组合。长文交给 MOC。

MOC：只做导航的笔记

MOC（Map of Content）不含原创内容，只放链接和一句话说明：

# MOC · 分布式系统

## 基础理论
- [[CAP 定理]] — 一致性、可用性、分区容忍不可兼得
- [[BASE 理论]] — CAP 的工程妥协方案

## 组件
- [[一致性哈希]] — 数据分片的核心算法
- [[Raft 协议]] — 易理解的共识算法

## 待办
- [ ] 补齐 [[向量时钟]] 的笔记

用法：每周回顾时打开图谱，看到成团的聚类就提炼成一个新 MOC。

30 分钟搭好第一个库

按顺序做完这 6 件事，能省掉后面 90% 的返工。

步骤	动作	位置
1	打开“自动更新内部链接”	设置 → 文件与链接
2	附件默认位置设为”指定文件夹”，如 `attachments`	设置 → 文件与链接
3	启用日记、模板、书签、大纲、标签核心插件	设置 → 核心插件
4	主题选 Minimal（可选）	设置 → 外观
5	建 4～6 个顶层文件夹（照上面那棵树）	文件列表
6	写 `首页.md` 作为入口，放几个链接	库根目录

先别急着装插件。 用核心功能写够两周，等你明确感到”这里很别扭”，再去搜对应插件——这是几乎所有老用户的共同建议。插件越多，启动越慢，升级越容易坏。

Windows 端建议用 .exe 安装包而不是便携版，这样文件关联、系统”打开方式”才正常。

从 1.14 起支持”打开库外的单个 Markdown 文件”，但必须下载最新安装包重新安装，仅靠自动更新不够。装完可以把 Obsidian 设为系统默认的 Markdown 打开程序。

必会的 6 个操作

操作	快捷键（Win / Mac）	说明
快速切换笔记	`Ctrl+O` / `Cmd+O`	模糊搜索笔记名，最高频
命令面板	`Ctrl+P` / `Cmd+P`	所有功能都在这里，记不住快捷键就往这找
全库搜索	`Ctrl+Shift+F` / `Cmd+Shift+F`	搜正文内容
切换编辑/阅读	`Ctrl+E` / `Cmd+E`
重命名	`F2`	自动更新全库链接，别用系统文件管理器改名
分栏 / 新窗口	拖动标签页到边缘 / 最外侧	`Ctrl+Alt+点击` 链接 = 新分栏

三种编辑模式：实时预览（默认，光标行显示语法，日常写作）、源码模式（调表格、写复杂语法）、阅读模式（纯渲染，不可编辑）。用 Ctrl/Cmd+E 切换。

书签可以把常用笔记、甚至某次搜索的条件存下来，左侧栏一键直达。

双向链接：Obsidian 的灵魂

在 A 里写 [[B]]，是正向链接；B 的右侧面板会自动列出”谁引用了我”，还会带上下文片段，这是反向链接。你不需要在 B 里手动维护”被 A 引用”，关系是自动双向的。

五个真正拉开效率差距的技巧：

先写链接，后建笔记。写到一半想引用一个还不存在的概念，直接 [[概念名]] 打下去，它会显示成灰色的”未创建链接”，点一下即创建。这叫自下而上生长，比先设计目录再填内容高效得多。
用好别名。在 YAML 写 aliases: [AI, 人工智能]，[[AI]] 和 [[人工智能]] 就指向同一篇，避免同一个东西在不同笔记里叫不同名字。
块引用。段落末尾加 ^块ID，别处用 [[笔记名#^块ID]] 精确引用这一段，适合引用长文里的某一句。
区分嵌入和链接。[[B]] 只是跳转入口；![[B]] 把 B 的内容直接嵌进当前笔记——会议记录嵌进周报就靠这个。
重命名必须在 Obsidian 里做。右键重命名或 F2，它会自动改写全库链接；用系统文件管理器改名，链接会全断。

图谱视图是诊断工具，不是写作界面。调 Filters 隐藏孤立点，按标签或文件夹着色——看到密集团块就是值得提炼的主题，看到孤零零的节点就是该补链接或合并的笔记。每周看一次足矣。

属性与标签怎么分工

属性就是笔记顶部的 YAML Frontmatter，用 --- 包起来：

---
title: Raft 协议
aliases: [Raft, raft-consensus]
tags:
  - 分布式/共识算法
  - 状态/已整理
status: 进行中
created: 2026-10-12
rating: 4
---

支持的类型：文本（status: 进行中）、列表（tags: [a, b] 或换行写）、数字（rating: 4）、复选框（done: true）、日期（created: 2026-10-12，供排序用）。

属性最容易踩的四个坑

三个特殊属性的标准名是 tags / aliases / cssclasses（复数），旧写法 tag / alias / cssclass 自 1.4 起已废弃；且值必须是列表，写单一文本不生效
updated 这类字段不会自动更新，要由 Templater 或插件维护
属性值里可以直接写 [[链接]]，Obsidian 会解析成链接类型
右侧栏的属性面板可以图形化编辑，不用手敲 YAML；设置里有全局属性视图，能看到整个库用了哪些属性

什么时候用属性、什么时候用标签，记住一条分界线就够了：

场景	属性	标签
有明确取值范围（状态、评分、日期）	✓
需要排序、筛选、计算、显示成表格列	✓
层级分类（`#领域/编程/前端`）		✓
临时标记、快速打点		✓

经验法则：能用属性描述的结构化信息，就不要塞进标签。

标签本身也有纪律：全小写、用 / 分层、先定 10 个以内的顶层标签（#项目 #领域 #资源 #状态）再往下细分，别让标签变成第二个文件夹系统。

模板：从内置到 Templater

内置模板插件只能填静态变量，够用但很浅：

设置 → 核心插件 → 打开模板
指定模板文件夹，如 90-Templates
写一个模板文件，用 {{date}} {{title}} 这类变量
使用时：命令面板 → “插入模板”

Templater 的会议笔记模板

社区插件 Templater 支持弹窗询问、条件判断、执行 JS、自动移动和重命名文件。一个实用的会议模板：

---
created: <% tp.date.now("YYYY-MM-DD") %>
type: meeting
attendees: <% await tp.system.prompt("参会人（逗号分隔）") %>
status: 待整理
---

# <% tp.file.title %>

## 议题

## 结论

## 行动项
- [ ]

配合它的文件夹模板功能，可以实现”新建到某个文件夹就自动套模板”，全程零手动。

插件	用途
Templater	动态模板，首选
QuickAdd	一键捕获、宏命令、批量创建
Periodic Notes	周记 / 月记 / 季记
Calendar	日历式浏览与创建日记

插件：少而准

核心插件是官方内置、免费、安全的；社区插件是第三方写的，能读你库里所有文件。截至 2026 年 10 月，官方社区目录已有 9000+ 个插件、900+ 个主题，这个数字还在涨。

筛选只看三条：

最近提交时间：超过一年没更新的，谨慎（Obsidian 迭代快，容易失修）
issue 状态：开放一堆且无人回应的，避开
能否被核心功能替代：能替代就别装

打开来源不明的库有风险——里面可能捆绑恶意插件配置。从 1.14 起，打开不受信任的库时，主题和代码片段会被临时禁用，直到你确认信任作者。点 obsidian:// 链接同理，从 1.13 起会先弹确认框。

值得先了解的插件，按需求挑，不要全装：

插件	适用场景
Templater	动态模板（见上节）
Style Settings	给支持它的主题提供可视化调节
Excalidraw	手绘风格图表
Omnisearch	大库全文搜索，比内置快
Advanced Tables	表格编辑增强
Obsidian Git	自动提交与备份

Bases 与 Dataview

Bases 是官方核心插件，把”一组笔记 + 它们的属性”变成可交互的数据库视图：表格、卡片、列表、看板、地图，数据始终是你本地的 Markdown 文件。Dataview 是社区插件，公式更灵活、老用户生态更大；新项目直接用 Bases 就够，需要复杂查询再上 Dataview。

用 Dataview 做首页仪表盘

在 首页.md 里放几个查询块，打开 Obsidian 第一眼看到的就是当前状态：

## 最近 7 天修改
```dataview
TABLE file.mtime AS "修改时间"
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC
LIMIT 15
```

## 本周待办
```dataview
TASK
WHERE !completed AND due <= date(today) + dur(7 days)
```

Dataview 是只读查询，永远不会改你的文件，可以放心实验。

Bases 和 Dataview 都依赖 YAML 属性质量。属性写得乱，视图就是一盘散沙——先规范属性，再建视图。上手时只加 3～4 列，跑通了再加公式和看板。

同步与备份：别把库放进网盘按需目录

方案	优点	缺点
官方 Sync	端到端 AES-256 加密、版本历史、手机端体验最好	收费；标准版 1 GB / 单文件 5 MB，存图片 PDF 很快吃紧
iCloud Drive	Mac/iOS 无缝	Windows 端常出问题，不适合跨平台
坚果云 / OneDrive	免费额度够用	移动端体验差，易产生冲突副本
Git（Obsidian Git）	完整历史、可回滚、纯文本天然适配	手机端配置麻烦，二进制附件撑大仓库
Syncthing	完全自控、免费	需要一台常开设备，配置门槛高

官方服务	价格（年付）	说明
Sync 标准	$4/月	1 个库、1 GB、单文件 ≤ 5 MB、1 个月历史
Sync Plus	$8/月	10 个库、10 GB（可扩至 100 GB）、单文件 ≤ 200 MB、1 年历史
Publish	$8/站点/月	把笔记发布成网站

学生、教职员工、非营利组织员工可享 Sync 与 Publish 40% 折扣，两者都支持 7 天内全额退款。

致命坑：不要把库直接放在 OneDrive / iCloud / 坚果云的”按需下载”目录里。

这些服务会把文件冻结成占位符，Obsidian 读取时触发下载，结果是链接莫名断裂、附件打不开、出现越滚越多的”冲突副本”、索引重建导致搜索失效。

正确做法：库放本地固定目录（如 D:\Vaults\知识库），再用 Sync 或 Obsidian Git 做多端同步与版本管理。

最低成本的备份方案就是 Git。库根目录执行一次：

cd /path/to/vault
git init
printf '.obsidian/workspace*.json\n.obsidian/cache\n.trash/\n' > .gitignore
git add .
git commit -m "init vault"

.gitignore 的作用是忽略易变的界面状态，避免每次提交都产生无意义 diff。之后交给 Obsidian Git 定时提交推送，你就同时获得了完整历史、免费多端同步和可审计的 diff。

别忘了核心插件里的文件恢复——它保留快照，误删时能救急；Sync 用户还能在同步历史里直接打开受影响文件。

七个新手坑

#	坑	后果	正确做法
1	一上来装 20 个插件	启动慢、维护成本高、升级就炸	先用核心功能两周，按需再装
2	先设计三层文件夹体系	体系很快过时，笔记塞不进去	顶层 4～6 个文件夹，靠链接组织
3	库放进网盘按需同步目录	链接断、冲突副本	本地目录 + Git / Sync
4	用系统文件管理器重命名	全库链接断裂	用 Obsidian 内 `F2` 重命名
5	沉迷图谱视图	花时间看连线，不产出内容	每周看一次，当诊断工具
6	把 AI 原文整段存进库	无来源的”正确废话”污染知识库	只存验证过的结论，连同来源一起存
7	不做备份	一次误操作全没	第一天就上 Git 或 Sync