第1章：环境与 vault 地图

本章结构：先理解 Obsidian / vault / 插件是什么 → 再新建「我的书架」并启用插件。
预计时间：概念 10 分钟 + 实操 20 分钟

1. Obsidian 与 vault 的概念

Obsidian 是一款本地优先的 Markdown 笔记应用。
一个 vault（库） = 电脑上的一个普通文件夹，里面放 .md 笔记、图片，以及隐藏的配置目录 .obsidian/。

这个设计乍看有点绕——为什么一个笔记软件不自己管数据，非要用一个文件夹？好处其实在后面：

• 你不需要 Obsidian 来读你的笔记。任何文本编辑器都能打开 .md 文件，你的数据不会被绑架。
• 备份就是复制文件夹。不需要进软件做导出，直接去文件管理器复制粘贴就行。
• 同步策略灵活。因为就是一个文件夹，你可以用 OneDrive、Dropbox、Git，甚至是 rsync 命令来同步——不限制你必须用官方的同步服务。

本教程假设你第一次搭建库，用示例名 「我的书架」 跟着做（名字可改，文件夹结构一致即可）。

本教程不预设你已经有一个叫 Work 的库，也不假设库里已有书籍、模板。

我们用一个假想示例跟着做：

后文所有路径（Books/、Tools/Templater/…）都指这个库的根目录。
若你已有自己的库，只要文件夹结构一样，把「我的书架」换成你的库名即可。

💡 作者编写本教程时用的是名为 Work 的库，结构和下面的示例完全一致，只是名字不同。

建好后，库会长什么样

flowchart TB
  W[我的书架 vault]
  W --> B[Books/ 放书籍笔记]
  W --> N[Notes/ 或 蒸馏术/ 放教程、随笔]
  W --> T[Tools/Templater/ 放模板]
  W --> A[assets/ 放封面图]
  W --> O[.obsidian/ 插件与设置 自动生成]
  W --> C[.claudian/ Claudian 配置 稍后才有]
  O --> P[plugins/ 各插件 data.json]

跟着做：新建库「我的书架」

步骤

1. 打开 Obsidian（首次启动会看到欢迎页）
2. 点击 Create new vault（创建新库）
3. Vault name 填：我的书架
4. Location 选一个你记得住的路径，例如：
   • Windows：文档\Obsidian\我的书架
   • macOS：~/Documents/Obsidian/我的书架
5. 点 Create

验证：窗口标题或左下角库切换器显示 我的书架；左侧文件树几乎是空的（可能只有一个默认的「欢迎」笔记，删掉也无妨）。

跟着做：手动建文件夹

初看这一步可能觉得多余——不就是新建几个文件夹吗？但文件夹结构是工作流的物理基础。后续的操作（Templater 模板放在哪、Douban 导入的书存到哪、Dataview 从哪查）全部依赖于这里确定的路径。一开始就定好，后面才不会乱。

Obsidian 不会自动帮你建 Books/ 等业务文件夹，需要自己来：

1. 在左侧文件树 根目录 上右键 → New folder
2. 依次创建：

3. （可选）如果你正在读这份教程的 markdown 原稿，可以在 Notes/ 下建一个 Obsidian工作流指南/ 文件夹，把本章节放进去

验证：展开根目录，能看到上表四个路径；Tools/Templater/ 里暂时可以是空的——第 4 章再创建模板。

.obsidian/ 是什么（不用手建）

创建库后，Obsidian 会在库根目录自动生成隐藏文件夹 .obsidian/：

我的书架/
├── .obsidian/
│   ├── plugins/              ← 安装插件后出现
│   ├── community-plugins.json
│   └── workspace.json        ← 窗口布局（多设备同步时建议排除）
├── Books/
├── assets/
├── Tools/Templater/
└── Notes/

一般不必在资源管理器里找 .obsidian；在 Obsidian 设置里操作插件即可。

下一篇 第2章：Remotely Save 会教你把 .obsidian/plugins/ 同步到其他设备。

跟着做：启用社区插件

在开始之前，理解一下 Obsidian 的插件机制会帮助你后续更顺利地操作。

Obsidian 的插件体系分为两层。底层是核心插件——软件自带的那批（日记、大纲、文件恢复等），开箱即用，不需要安装。上层是社区插件——由第三方开发者编写，需要通过社区插件市场来安装。本教程涉及的插件全部属于后者。

首次安装社区插件时，Obsidian 会提示「限制模式」（Restricted mode），这是安全机制——关闭它意味着你信任你要安装的那些插件。确实如此：社区插件有读写你 vault 文件的权限，所以只从可信来源安装。

操作步骤：

1. 设置 ⚙️ → 社区插件
2. 若提示 Restricted mode（限制模式）→ 点 Turn off restricted mode
3. 点 Browse（浏览），搜索并 Install + Enable 下表插件

本教程推荐的插件安装顺序（先同步、再 AI、再录入）：

4. 装完后切到 Installed（已安装），确认开关都是 ON

验证：Ctrl+P（Mac：Cmd+P）输入 Remotely Save，能看到 Sync now 一类命令；输入 Templater 也有相关命令。

跟着做：Templater 路径预检

1. 设置 → Templater
2. Template folder location 点文件夹图标 → 选 Tools/Templater
3. 保存

验证：此时模板列表可能还是空的——正常，第 4 章会新建 Books.md。

桌面 vs 移动端（提前了解分工）

这个主题在导读里已经提过，这里用更具体的插件列表再梳理一遍。目的是让你在阅读后续章节时有个预期：哪些操作只能在桌面完成，哪些在手机上也可以做。

flowchart LR
  subgraph desktop [桌面 Windows/Mac]
    D1[Remotely Save ✅]
    D2[Claudian ✅]
    D3[Templater 复杂脚本 ✅]
    D4[Douban 登录 ✅]
  end
  subgraph mobile [手机 可选]
    M1[Remotely Save ✅]
    M2[Dataview ✅]
    M3[Navigator ✅]
    M4[Claudian ❌]
  end
  desktop -->|Sync| mobile

只有一台电脑也可以跟完本教程；手机是「Sync 后在路上读」的加分项。

练习（本章做完应达到的状态）

学完这一章后，你的 Obsidian 应该处于以下状态。如果还有没完成的，建议回到对应小节补上：

• 已新建库 我的书架（或你自己起的名字），路径你记得住
• 根目录下有 Books/、assets/、Tools/Templater/（暂时都是空的，没关系）
• 社区插件里已安装：Remotely Save、Templater、Dataview、Notebook Navigator、Douban
• Templater 的模板文件夹已设置指向 Tools/Templater
• 想好了下一步打算用哪种云做 Remotely Save（OneDrive / S3 / WebDAV 等）——下一章就要配置了

还没有任何书籍笔记？很正常。 第 4 章用 Douban 导入第一本书后，Books/ 文件夹里才会有内容出现。

常见问题