1.1 为什么选择Obsidian？#

在众多笔记软件中，Obsidian凭借其独特的理念脱颖而出：

• 本地存储：你的笔记就是普通的Markdown文件，存在你自己的设备上，不依赖任何云服务
• 双向链接：通过[[]]语法轻松建立笔记之间的关联，形成知识网络
• 图谱视图：可视化展示笔记之间的关系，让你看到知识的全貌
• 插件生态：超过1000+社区插件，几乎可以实现任何你想要的功能
• 完全免费：个人使用完全免费，付费的只是可选的云同步服务

1.2 Obsidian vs 其他笔记软件#

结论：如果你重视数据隐私、需要离线使用、喜欢折腾自定义，Obsidian是最佳选择。如果你需要团队协作、不想折腾，Notion可能更适合。

2.1 下载安装#

Obsidian支持全平台：

• Windows/macOS/Linux：访问 obsidian.md 下载安装包
• Android/iOS：在应用商店搜索”Obsidian”下载
• 网页版：官方不提供，但可以通过服务器部署code-server实现

2.2 创建第一个Vault（仓库）#

1. 打开Obsidian，点击”Create new vault”
2. 输入仓库名称（建议用英文，如”my-notes”）
3. 选择存储位置（建议放在容易备份的位置）
4. 点击”Create”完成创建

小贴士：一个Vault就是一个普通的文件夹，里面包含你的所有笔记（.md文件）和配置（.obsidian文件夹）。你可以随时用文件管理器打开它。

2.3 界面布局#

Obsidian的界面主要分为：

• 左侧边栏：文件资源管理器、搜索、书签
• 中央区域：笔记编辑区（支持分屏）
• 右侧边栏：大纲、反向链接、图谱
• 底部状态栏：字数、阅读时间、当前模式

2.4 基础设置优化#

进入设置（Ctrl+,），建议调整：

1
外观 → 基础颜色：根据喜好选择浅色/深色
2
编辑器 → 行号：开启
3
编辑器 → 显示当前行高亮：开启
4
文件与链接 → 默认新建笔记位置：选择"当前文件所在的文件夹"
5
文件与链接 → 使用Wiki链接：开启（推荐）

3.1 基础语法#

1
# 一级标题
2
## 二级标题
3
### 三级标题
4

5
**加粗文本**
6
*斜体文本*
7
~~删除线~~
8
`行内代码`
9

10
- 无序列表
11
1. 有序列表
12
- [ ] 任务列表（未完成）
13
- [x] 任务列表（已完成）
14

15
> 引用块
16

17
---
18

19
| 表头1 | 表头2 |
20
|:---|:---|
21
| 单元格 | 单元格 |

3.2 Obsidian扩展语法#

双向链接（核心功能）：

1
[[笔记标题]]          → 链接到其他笔记
2
[[笔记标题|显示文字]]  → 自定义显示文字
3
[[笔记标题#标题]]     → 链接到笔记的特定章节
4
![[图片.png]]         → 嵌入图片
5
![[笔记标题]]         → 嵌入整个笔记

标签：

1
#标签
2
#父标签/子标签

Callout提示框：

1
> [!note] 提示
2
> 这是一个提示框
3

4
> [!warning] 警告
5
> 这是一个警告框
6

7
> [!tip] 小贴士
8
> 这是一个小贴士

高亮：

1
==高亮文本==

数学公式：

1
行内公式：$E = mc^2$
2
块级公式：
3
$$
4
\sum_{i=1}^{n} x_i = x_1 + x_2 + ... + x_n
5
$$

4.1 安装插件#

1. 设置 → 第三方插件 → 关闭”安全模式”
2. 点击”浏览”进入社区插件市场
3. 搜索并安装你需要的插件
4. 启用插件并配置

4.2 必装插件推荐#

4.3 插件配置示例：Dataview#

Dataview可以将你的笔记变成数据库：

1
// 列出所有未完成的任务
2
TASK
3
WHERE !completed
4
LIMIT 10
5

6
// 列出最近修改的笔记
7
TABLE file.mtime AS "修改时间"
8
FROM ""
9
SORT file.mtime DESC
10
LIMIT 10
11

12
// 统计每个标签的笔记数量
13
TABLE length(rows) AS "数量"
14
FROM #标签
15
GROUP BY tags

5.1 方案对比#

5.2 方案一：Remotely Save + 坚果云（推荐国内用户）#

原理：通过WebDAV协议将笔记同步到坚果云。

步骤：

1. 注册坚果云账号
2. 在坚果云中创建应用：
   • 设置 → 安全选项 → 第三方应用管理
   • 添加应用，获取密码
3. 在Obsidian中安装”Remotely Save”插件
4. 配置插件：

   1
   Remote Service: WebDAV
   2
   Server Address: https://dav.jianguoyun.com/dav/
   3
   Username: 你的坚果云邮箱
   4
   Password: 第三方应用密码

5. 点击”Check”测试连接
6. 开启”自动同步”

优点：免费、稳定、国内速度快 缺点：坚果云免费版有流量限制（1GB/月上传，3GB/月下载）

5.3 方案二：Git + GitHub（程序员首选）#

原理：将笔记仓库用Git管理，推送到GitHub。

步骤：

1. 在GitHub创建私有仓库
2. 在Obsidian安装”Git”插件
3. 配置插件：

   1
   Auto pull interval: 5
   2
   Auto push interval: 5
   3
   Pull updates on startup: 开启
   4
   Push on backup: 开启

4. 初始化仓库并推送：

   1
   打开命令面板（Ctrl+P）
   2
   输入 "Git: Initialize git repository"
   3
   输入 "Git: commit all changes"
   4
   输入 "Git: push"

优点：免费、有版本历史、可回滚 缺点：需要Git知识、同步有延迟

5.4 方案三：Syncthing（注重隐私）#

原理：P2P直接同步，不经过任何服务器。

步骤：

1. 在所有设备安装Syncthing
2. 添加设备（扫描二维码或输入设备ID）
3. 共享笔记文件夹
4. 等待同步完成

优点：完全免费、无流量限制、隐私安全 缺点：需要设备同时在线、初次配置复杂

5.5 方案四：服务器中转（有服务器的用户）#

原理：在服务器上部署同步服务，所有设备连接到服务器。

方案A：Gitea + Git插件

如果你有Gitea服务器（端口3000），可以：

1. 在Gitea创建私有仓库
2. 配置Git插件指向Gitea服务器
3. 享受免费的私有同步

方案B：code-server + Foam

如果你想在任何设备上通过浏览器使用Obsidian：

1. 在服务器安装code-server
2. 安装Foam插件（VS Code的Obsidian替代）
3. 通过浏览器访问 http://服务器IP:8080

优点：随时随地访问、数据完全掌控 缺点：需要服务器、带宽有限（如3M带宽）

6.1 模板系统#

使用Templater插件创建模板：

1
---
2
title: <% tp.file.title %>
3
date: <% tp.date.now("YYYY-MM-DD") %>
4
tags: [日记]
5
---
6

7
# <% tp.file.title %>
8

9
## 今日目标
10
- [ ]
11

12
## 今日记录
13

14
## 今日总结
15

16
## 明日计划
17
- [ ]

将模板放入模板文件夹，然后通过命令面板插入。

6.2 Dataview进阶#

创建动态笔记索引：

1
TABLE file.ctime AS "创建时间", file.size AS "大小"
2
FROM ""
3
WHERE file.folder = "项目"
4
SORT file.ctime DESC

统计字数：

1
TABLE length(file.content) AS "字数"
2
FROM ""
3
SORT length(file.content) DESC
4
LIMIT 10

任务看板：

1
TASK
2
WHERE contains(text, "#重要") AND !completed
3
GROUP BY file.link

6.3 快捷键自定义#

进入设置 → 快捷键，建议自定义：

1
Ctrl+N：新建笔记
2
Ctrl+O：快速打开
3
Ctrl+P：命令面板
4
Ctrl+E：切换编辑/预览模式
5
Ctrl+Shift+F：全局搜索
6
Ctrl+G：图谱视图

6.4 笔记组织策略#

PARA方法：

• Projects：当前进行的项目
• Areas：持续关注的领域
• Resources：感兴趣的资源
• Archives：已完成或不再活跃的内容

Zettelkasten卡片盒笔记法：

1. 每个笔记只写一个想法
2. 用自己的话重新表述
3. 通过双向链接建立关联
4. 定期回顾和整理

Q1：Obsidian免费吗？#

A：完全免费！付费的只是可选的云同步服务（Obsidian Sync，$8/月）和官方发布服务（Obsidian Publish，$16/月）。所有核心功能和插件都是免费的。

Q2：笔记存在哪里？#

A：存在你选择的本地文件夹中，就是普通的.md文件。你可以随时用其他编辑器打开，也可以用文件管理器备份。

Q3：如何备份？#

A：

• 简单备份：直接复制整个Vault文件夹
• Git备份：用Git管理，推送到GitHub/Gitea
• 云备份：用Syncthing或坚果云自动同步

Q4：插件安全吗？#

A：社区插件都是开源的，代码可在GitHub查看。但建议只安装知名插件，避免安装来源不明的插件。

Q5：Obsidian和AFFiNE哪个好？#

A：取决于你的需求：

• Obsidian：本地优先、插件丰富、适合个人知识管理
• AFFiNE：云端优先、界面现代、适合团队协作

如果你是个人用户，且重视数据隐私，推荐Obsidian。如果你的服务器内存有限（如3.6GB），AFFiNE可能会比较吃力。

官方资源#

• Obsidian官方文档
• Obsidian论坛
• Obsidian Discord

中文社区#

• Obsidian中文论坛
• PKMer社区
• 少数派Obsidian专题

推荐YouTube频道#

• Nicole van der Hoeven
• FromSergio
• Bryan Jenks
• Productive Dude