2026 深度升级版 · v3.0
obsidian v1.9+ · 全面覆盖最新功能

Obsidian
终极完全指南

全网最系统、最完整的 Obsidian 使用教程。从零配置到高级工作流,含完整模板代码、Dataview进阶查询、10大常见误区、移动端专项指南,一册在手,彻底精通。

15
核心章节
60+
详细步骤
25+
代码模板
40+
快捷键
10
避坑指南
CHAPTER 00
什么是 Obsidian?
核心理念、竞品对比、适合人群全面解析
💡
一句话定义Obsidian 是一款本地优先、基于纯 Markdown 的知识管理工具,以双向链接和关系图谱为核心,帮助你建立"第二大脑"。2020年创立,2026年2月宣布商业用途永久免费,社区插件超 2000 个。
🔒
本地优先,永不锁定
所有笔记以纯 .md 文件存储在本地,格式开放,软件停更笔记依然永久可用。
隐私安全
🕸️
双向链接,知识成网
[[双括号]] 将笔记互联,不仅能看当前引用了谁,还能看谁引用了当前笔记(反向链接)。
核心功能
🗺️
知识图谱,可视化
图谱视图将所有笔记渲染为动态星系图,直观展现知识全貌,发现意外关联。
可视化
🧩
2000+ 社区插件
官方核心插件 + 社区 2000+ 插件,从简单编辑到 AI 辅助、项目管理应有尽有。
可扩展
🆓
完全免费含商业
2026年2月官方宣布商业用途也免费,无需担心授权,企业团队也可放心使用。
永久免费
🖥️
全平台覆盖
Win / macOS / Linux 桌面端 + iOS / Android 移动端,一个知识库多端访问。
跨平台
与主流竞品深度对比
功能ObsidianNotionRoam ResearchLogseq
本地存储✅ 纯本地❌ 仅云端❌ 仅云端✅ 本地
双向链接✅ 强力⚡ 基础✅ 核心✅ 强力
标准Markdown✅ 完全支持⚡ 有限⚡ 定制语法✅ 支持
插件数量✅ 2000+⚡ 有限⚡ 较少⚡ 中等
完整离线✅ 完整⚡ 有限❌ 需联网✅ 完整
免费程度✅ 商业免费⚡ 免费有限❌ $15/月✅ 开源免费
学习曲线中等较低较高中等
推荐人群知识工作者/研究者团队协作网状笔记发烧友大纲爱好者
⬇️
CHAPTER 01
下载与安装
从官网下载到完成首次配置的全程详细指引
🇨🇳
国内用户特别提示官方服务器在海外,国内下载可能缓慢或中断。推荐从 Obsidian 中文论坛(forum-zh.obsidian.md)下载社区成员搬运的安装包,完全安全,版本与官方同步。插件市场同理,可通过 pkmer.cn 获取插件镜像。
1
选择平台并下载
访问 https://obsidian.md/download,根据系统选择:

Windows:推荐 Obsidian-x.x.x-user.exe(User Installer,无需管理员权限)
macOS Apple SiliconObsidian-x.x.x-arm64.dmg;Intel Mac:x86_64.dmg
Linux:推荐 .AppImage(通用)或 snap install obsidian --classic
iOS/Android:App Store / Google Play 搜索 "Obsidian" 官方应用(免费)
2
安装程序(Windows 详解)
双击 .exe → 选"仅为我安装(推荐)" → 修改路径至非系统盘:D:\Software\Obsidian → 勾选"创建桌面快捷方式" → 安装完成后软件自动启动。

macOS 注意:将 Obsidian.app 拖入 Applications 文件夹。若提示"无法验证开发者",进入 系统设置→隐私与安全→仍然允许打开。
3
创建第一个知识库(Vault)
知识库是所有笔记的根文件夹,所有 .md 文件都存于其中。

· 启动后点击 "新建知识库"
· 输入名称:如 MyVault(建议纯英文,避免路径问题)
· 选择路径:推荐 D:\MyVault(非系统盘,路径无中文无空格)
· 点击创建
⚠️ 路径禁区:绝对不要将 Vault 放在 iCloud / OneDrive 自动同步文件夹内(如 C:\Users\用户名\OneDrive\...),会引发文件冲突和数据损坏。如需云同步,使用第14章专项方案。
4
切换中文界面
点击左下角 ⚙️ 设置图标General(通用)Language 下拉框 → 选择 简体中文 → 点击 Relaunch(重启),完成语言切换。
5
初始化必做配置
设置 → 文件与链接
· "新笔记的默认位置" → Inbox(先创建此文件夹)
· "附件默认保存位置" → Assets(统一管理图片附件)
· 开启"使用 Wiki 链接"

设置 → 编辑器
· 默认编辑模式 → "实时预览(Live Preview)"
· 行宽 → "放宽"(避免文字过于拥挤)

设置 → 核心插件:开启 日记、模板、快速切换、标签列表、大纲、书签
🖥️
CHAPTER 02
界面布局与基本操作
深度拆解 Obsidian 每一区域与核心交互逻辑
🗂️ 五大界面区域
  • 左侧边栏:文件树、搜索、书签、标签面板、插件导航区
  • 中央编辑区:笔记编辑主区,支持多标签页 + 分屏
  • 右侧边栏:反向链接、大纲、属性、日历等面板
  • 状态栏(底部):字数统计、行列信息、当前视图模式
  • 命令面板Ctrl+P 呼出,几乎所有功能均可在此搜索执行
✏️ 三种编辑模式
  • 实时预览(Live Preview):所见即所得,输入语法即时渲染,日常首选
  • 源码模式(Source Mode):显示纯 Markdown 代码,精细操控格式时使用
  • 阅读模式(Reading View):完整渲染只读,适合整理好的文章查阅
  • 快速切换:Ctrl+E 在编辑和预览间切换
创建、重命名、删除笔记
创建Ctrl+N | 左侧文件区 "+" 图标 | 右键文件夹→新建笔记 | 输入 [[不存在的名称]] 点击自动创建

重命名:F2 | 双击标签页标题 | 右键文件→重命名。重命名时 Obsidian 自动更新全库所有指向该笔记的链接,无需手动查找替换。

删除:右键→删除,默认移入系统回收站(设置中可改为放入 .trash 文件夹)
分屏与多窗格高效操作
方法一:按住 Ctrl 点击链接/文件 → 在新标签页打开
方法二:右键任意文件/链接 → "在新窗格中打开"
方法三:拖拽标签页到编辑区边缘,出现蓝色指示时松开 → 实现左右/上下分屏
方法四:命令面板搜索"分屏" → 执行垂直/水平分屏命令

实用场景:左侧写源码查看 Dataview,右侧阅读模式实时预览效果;左侧写作,右侧开大纲导航。
搜索系统完整指南
全局搜索 Ctrl+Shift+F
· file:笔记名 仅搜文件名 | tag:#标签名 按标签搜索
· path:文件夹/ 限定路径 | /正则表达式/ 正则搜索
· line:内容 按行内容搜索 | content:关键词 全文搜索

快速切换 Ctrl+O:模糊搜索文件名快速跳转
文件内搜索 Ctrl+F:支持正则,区分大小写
属性(Properties)系统详解
v1.4 起提供图形化属性编辑界面,替代手写 YAML:

· 快捷键 Ctrl+; 或点击笔记顶部"+ 添加属性"打开
· 支持文本、数字、日期、复选框、列表等多种字段类型
· 属性值实时同步到文件 YAML Front Matter,Dataview 可直接查询
· 设置→属性 可管理全库属性类型定义
· v1.9 的 Bases 插件可像 Notion 数据库一样管理这些属性
✍️
CHAPTER 03
Markdown 完整语法精讲
标准语法 + Obsidian 扩展语法,完整对照参考表
效果Markdown 写法说明
一~六级标题# 到 ###### 标题# 后必须有空格,最多6级
粗体**粗体文字**两个星号包裹,快捷键 Ctrl+B
斜体*斜体文字*单星号,快捷键 Ctrl+I
粗斜体***粗斜体***三个星号
高亮文本==高亮内容==Obsidian 特有,标准MD不支持
删除线~~删除线~~两个波浪线
上标² / 下标₂^2^ / ~2~Obsidian 特有语法
行内代码`代码`反引号包裹
代码块```python...```三反引号+语言名,支持语法高亮
无序列表- 项目* 项目- 或 * 加空格,Tab缩进嵌套
有序列表1. 项目数字+点+空格
任务列表- [ ] 待办 / - [x] 已完点击复选框可直接切换状态
引用块> 引用内容可嵌套:>> 两层
分割线---三短横线单独一行
内部图片![[图片.png|500]]|后数字控制显示宽度px
外部链接[文字](https://url)Ctrl+K 快速插入
数学公式$E=mc^2$ 或 $$块级$$LaTeX 语法
脚注[^1] + [^1]: 内容v1.11+ 侧边栏管理
表格| 列1 | 列2 |冒号控制对齐,见下方说明
Callout 高亮块(Obsidian 特有)
CALLOUT 语法大全
> [!NOTE] 笔记提示(默认展开)
> 内容写在这里

> [!TIP]- 实用技巧(- 号表示默认折叠,点击展开)
> 折叠内容

> [!WARNING] 警告   > [!DANGER] 危险
> [!INFO] 信息       > [!SUCCESS] 成功
> [!QUESTION] 问题  > [!ABSTRACT] 摘要
> [!QUOTE] 引言     > [!BUG] 缺陷
Front Matter 属性系统完整示例
YAML FRONT MATTER
---
title: "深度学习笔记"
date: 2026-05-25
modified: 2026-05-26
tags:
  - AI
  - 机器学习
type: 技术笔记
status: 进行中       # 未开始 / 进行中 / 已完成 / 搁置
priority: 高          # 高 / 中 / 低
rating: 4             # 1-5 星
source: "书名或URL"
aliases:
  - DL笔记
  - 深学笔记
cssclasses:
  - wide-page         # 宽页面(需配合CSS片段)
---

笔记正文从这里开始...
🗂️
CHAPTER 05
笔记组织三大方法论
PARA / Zettelkasten / MOC — 找到最适合自己的系统
📐
PARA 方法(最流行)
Projects(项目)/ Areas(领域)/ Resources(资源)/ Archives(归档)。清晰实用,适合大多数人,与 GTD 完美配合。
新手推荐
🃏
Zettelkasten(卡片盒法)
闪念→文献→永久笔记三层结构,强调原子化和主动连接,适合学术研究和深度思考者,Obsidian 天然契合。
学术研究
🗺️
MOC 内容地图
创建专题"索引笔记"汇聚相关链接,灵活可扩展,可与 PARA/Zettelkasten 混用,适合大型知识库导航。
大型知识库
PARA 推荐文件夹结构
📁 MyVault/ ├── 📁 00-Inbox/ ← 所有新笔记暂存,定期整理 ├── 📁 01-Projects/ ← 有目标和截止日期的项目 │ ├── 📁 2026-博客改版/ │ └── 📁 2026-年度复盘/ ├── 📁 02-Areas/ ← 需要长期维护的生活领域 │ ├── 📁 健康管理/ │ └── 📁 职业发展/ ├── 📁 03-Resources/ ← 按主题存放的参考资料 │ ├── 📁 技术/AI/ │ └── 📁 读书笔记/ ├── 📁 04-Archives/ ← 已完成或暂停的内容 ├── 📁 05-Templates/ ← 所有模板文件 ├── 📁 06-Daily/ ← 每日日记(建议按年月子文件夹) │ └── 📁 2026/05/ └── 📁 Assets/ ← 图片、附件统一存放
💡
Inbox 优先原则(核心习惯)设置→文件与链接→"新笔记默认位置"选择 Inbox 文件夹。所有新笔记先进 Inbox,不要在创建时思考分类。等有整块时间(如每周一次)再统一整理。这是避免"分类焦虑"阻碍记录的关键策略。
🧩
CHAPTER 06
插件系统深度详解
核心插件配置 + 社区精选30+插件按场景分类推荐
🔧
安装社区插件(国内用户)设置→社区插件→关闭安全模式→浏览(需代理或用 PKMer 加速:pkmer.cn)。手动安装:下载 main.js、manifest.json 放入 .obsidian/plugins/插件ID/ 目录,重启后启用。
v1.8–1.9 重磅核心插件
🌐
网页浏览器(Web Viewer)— v1.8 新增
Obsidian 内置浏览器,可边查网页边记笔记,无需切换窗口。点击外部链接时选择"在浏览器中打开",完美融入工作流。
设置 → 核心插件 → 网页浏览器
v1.8新增
🗄️
Bases(数据集)— v1.9 重磅新增
类 Notion 数据库功能!基于 Front Matter 属性,支持表格/看板/画廊视图,可过滤、排序、分组,直接编辑属性值。创建方式:新建文件→选择"数据集(Base)"类型。比 Dataview 更直观,无需写查询语言,适合不喜欢代码的用户。
设置 → 核心插件 → Bases
v1.9重磅
社区四大金刚(必装)
📊
Dataview — 笔记数据库引擎
将知识库当数据库查询,支持 DQL(类SQL语法)和 DataviewJS(JavaScript)两种模式,生成动态列表、表格、任务看板、日历等。详见第08章完整教程。
ID: dataview
四大金刚
Templater — 强大模板引擎
支持 JavaScript 脚本、日期格式化、用户输入弹窗、条件逻辑、文件操作等。比核心模板插件强大数十倍。详见第07章完整模板代码库。
ID: templater-obsidian
四大金刚
🎨
Excalidraw — 手绘白板
在笔记内嵌入可编辑的手绘风格白板,支持流程图、思维导图、架构图,且图形内可包含 Obsidian 内部链接,实现图文混合知识管理。
ID: obsidian-excalidraw-plugin
四大金刚
QuickAdd — 快速捕获与工作流
四种功能:Template(套模板)、Capture(快速追加到指定文件)、Macro(执行宏命令)、Multi(组合多步骤)。构建个性化快捷工作流的核心工具。
ID: quickadd
四大金刚
其他强烈推荐(按场景分类)
📅 时间与任务管理类(5个)
📅
Calendar
侧边栏日历,点击日期打开日记,直观显示哪天有记录,追踪写作频率。
obsidian-calendar-plugin
强推
🔄
Periodic Notes
扩展日记支持周记、月记、季记、年记,配合Calendar插件构建完整时间复盘系统。
periodic-notes
推荐
Tasks
强大任务管理,支持到期日、优先级、重复任务、全库任务汇总查询,比 Dataview 任务管理更专业。
obsidian-tasks-plugin
强推
🏃
Rollover Daily Todos
自动将昨天未完成的任务转移到今天日记,告别手动复制粘贴。
obsidian-rollover-daily-todos
推荐
🗃️
Kanban
看板视图管理任务(类 Trello),卡片内容是 Markdown,可包含内部链接,适合项目管理可视化。
obsidian-kanban
推荐
✏️ 编辑增强类(6个)
🎒
Advanced Tables
Tab 在单元格间移动,自动对齐,支持公式,极大简化表格编辑。
table-editor-obsidian
必装
💬
Various Complements
文字自动补全,从笔记内容学习词库,输入前几字自动弹出候选。
various-complements
推荐
📎
Auto Link Title
粘贴 URL 时自动抓取网页标题,生成格式化的 Markdown 链接。
obsidian-auto-link-title
推荐
🔡
Linter
自动修复空行、标题格式、YAML 规范,保持全库笔记格式统一整洁。
obsidian-linter
推荐
🔤
Editing Toolbar
编辑区顶部显示格式化工具栏(粗体/斜体/标题按钮),对不习惯 Markdown 的用户友好。
editing-toolbar
推荐
🖼️
Image Toolkit
点击图片后可放大查看,支持鼠标滚轮缩放、拖拽移动,改善大图查看体验。
obsidian-image-toolkit
可选
📚 知识管理类(5个)
🃏
Spaced Repetition
在笔记中创建闪卡,间隔重复算法安排复习,适合语言学习和知识记忆。
obsidian-spaced-repetition
强推
📝
Annotator
在 Obsidian 内对 PDF 和 EPUB 直接高亮批注,注释自动保存为链接到具体位置的笔记。
annotator
推荐
📖
Book Search
从 Google Books API 搜索书籍,自动填充书名、作者、封面到 Front Matter,快速创建读书笔记。
obsidian-book-search-plugin
推荐
🌟
Readwise Official
Kindle 高亮、Web 剪藏、播客摘录自动同步到 Obsidian,构建完整输入流水线。需 Readwise 订阅。
readwise-official
进阶
🧠
Smart Connections (AI)
AI 驱动的语义相似度笔记关联推荐,自动发现相关笔记。需配置 OpenAI/本地模型 API。
smart-connections
AI功能
🎨 视觉美化类(4个)
🎨
Style Settings
图形界面调整主题颜色、字体、间距,无需手写 CSS,配合 Blue Topaz/Minimal 主题使用。
obsidian-style-settings
必装
🖼️
Banners
在笔记顶部添加横幅封面图,让笔记更有视觉感,支持本地文件或 URL 图片。
obsidian-banners
美化
📊
Charts
在笔记中创建折线图、柱状图、饼图等,数据直接写在 Markdown 代码块中。
obsidian-charts
推荐
🧭
Map View
将笔记中的地理位置信息可视化为地图,适合旅行日记、地点记录、田野调查笔记。
obsidian-map-view
可选
📋
CHAPTER 07 · 新增
模板系统实战代码库
即拿即用的完整模板:日记、读书笔记、会议记录、项目主页
前置条件安装并启用 Templater 插件,在设置中指定"模板文件夹"路径(如 05-Templates/)。将以下代码保存为对应 .md 文件,在任意笔记中通过命令面板搜索"Templater"→"Open Insert Template Modal"插入。
模板一:每日日记模板(最重要)
05-Templates/日记模板.md
---
date: <% tp.date.now("YYYY-MM-DD") %>
day: <% tp.date.now("dddd") %>
week: <% tp.date.now("YYYY-[W]WW") %>
type: daily
---

# 📅 <% tp.date.now("YYYY年MM月DD日 dddd") %>

## 🎯 今日三件事(最重要的任务)
- [ ] 🔴 (高优先级)
- [ ] 🟡 (中优先级)
- [ ] 🟢 (低优先级)

## 💭 晨间思考(3分钟)
*今天的主要目标?有什么值得期待?*


## 📝 工作笔记与思考


## 📚 今日阅读 / 学习
- **来源**:
- **核心收获**:
- **行动启示**:

## 🔗 今日创建 / 更新的笔记
- [[]]

## 🌙 每日回顾
**今天完成了什么?**

**今天学到了什么?**

**明天需要跟进:**
- [ ] 

**今日心情:** ⭐⭐⭐⭐⭐

---
← 昨天 [[<% tp.date.now("YYYY-MM-DD", -1) %>]] | 明天 [[<% tp.date.now("YYYY-MM-DD", 1) %>]] →
模板二:读书笔记模板
05-Templates/读书笔记模板.md
---
title: "<% tp.file.title %>"
author: <% await tp.system.prompt("作者名") %>
category: <% await tp.system.prompt("分类(技术/文学/商业等)") %>
status: 阅读中       # 待读 / 阅读中 / 已读 / 放弃
rating:              # 读完后填写 1-5
start_date: <% tp.date.now("YYYY-MM-DD") %>
finish_date:
type: book
tags: [读书笔记]
---

# 📖 <% tp.file.title %>

> **一句话总结**:

## 📌 基本信息
| 项目 | 内容 |
|------|------|
| 作者 | |
| 出版社 | |
| 出版年 | |
| 总页数 | |

## 🗝️ 核心观点(3-5个)
1. 
2. 
3. 

## 💎 精华摘录(标注页码)
> 摘录内容(P.xxx)

## 💭 个人思考
### 什么触动了我?

### 与已有认知的连接?

### 如何应用到实际?

## 🔗 相关笔记
- [[]]

## ⭐ 总评
**评分**:/5 | **推荐理由**:
模板三:会议记录模板
05-Templates/会议记录模板.md
---
date: <% tp.date.now("YYYY-MM-DD") %>
time: <% tp.date.now("HH:mm") %>
type: meeting
project: <% await tp.system.prompt("关联项目名称") %>
tags: [会议]
---

# 🤝 <% await tp.system.prompt("会议主题") %>

## 基本信息
- **日期**:<% tp.date.now("YYYY-MM-DD HH:mm") %>
- **参会人员**:
- **会议形式**:线下 / 线上

## 📋 议程
1. 
2. 

## 📝 讨论要点

## ✅ 决策事项
- [ ] 

## 🎯 行动项(谁 · 做什么 · 截止日期)
| 负责人 | 任务 | 截止日期 |
|--------|------|----------|
| | | |

## ❓ 遗留问题
模板四:项目主页模板
05-Templates/项目模板.md
---
project: "<% tp.file.title %>"
status: 进行中       # 计划中 / 进行中 / 暂停 / 已完成
start: <% tp.date.now("YYYY-MM-DD") %>
deadline:
priority: 中
type: project
tags: [项目]
---

# 🚀 <% tp.file.title %>

## 🎯 项目目标
**一句话**:

**成功标准**(可检验的具体指标):
- 

## 📋 任务分解
```tasks
not done
path includes <% tp.file.path(true) %>
```

## 📝 项目日志
### <% tp.date.now("YYYY-MM-DD") %>
- 项目启动

## 🔗 相关资料
📊
CHAPTER 08 · 新增
Dataview 进阶完整指南
从基础 DQL 查询到 DataviewJS 高级用法,含20+实用代码
⚙️
Dataview 安装后必做设置插件设置界面:① 开启 "Enable JavaScript Queries"(DataviewJS功能);② 日期格式设为 yyyy-MM-dd;③ 开启 "Enable Inline Queries"(行内查询 `=字段名`);④ 保持"元数据自动提取"默认开启。
查询类型关键词用途说明
列表视图LIST显示笔记链接的简单列表,可附加一个额外信息字段
表格视图TABLE显示多列属性的完整表格,最常用
任务视图TASK显示可交互勾选的任务列表,支持跨笔记汇总
日历视图CALENDAR按日期字段在日历上显示笔记,直观查看时间分布
核心语句语法详解
DQL 完整语法结构
```dataview
[LIST|TABLE|TASK|CALENDAR] [字段1, 字段2, ...]
FROM [数据源]        -- 必填,指定查询范围
WHERE [过滤条件]     -- 可选,过滤笔记
SORT [字段] [ASC|DESC]  -- 可选,排序
LIMIT [数量]         -- 可选,限制结果数
GROUP BY [字段]      -- 可选,分组
FLATTEN [字段]       -- 可选,展开数组字段
```

-- 数据源(FROM)写法:
FROM ""                    -- 整个知识库
FROM "Projects"            -- 指定文件夹(注意大小写)
FROM #标签名               -- 带有该标签的所有笔记
FROM [[某笔记]]            -- 链接到该笔记的所有笔记
FROM "Folder1" OR #tag1    -- 多条件 OR
FROM "Folder1" AND #tag1   -- 多条件 AND
FROM -"Archives"           -- 排除某文件夹

-- 常用 WHERE 条件:
WHERE status = "进行中"
WHERE date >= date(today) - dur(7 days)
WHERE !completed
WHERE contains(tags, "学习")
WHERE file.size > 500
WHERE date = date(today)
20+ 实用查询代码(直接复制使用)

① 进行中项目表格

```dataview
TABLE status, deadline, priority
FROM "Projects"
WHERE status = "进行中"
SORT priority DESC
```

② 最近7天修改的笔记

```dataview
LIST FROM ""
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC
LIMIT 15
```

③ 读书管理列表

```dataview
TABLE author, status, rating
FROM #读书笔记
SORT rating DESC, file.name ASC
```

④ 今日未完成任务

```dataview
TASK FROM "Daily"
WHERE !completed
WHERE date = date(today)
```

⑤ 孤立笔记(无任何链接)

```dataview
LIST FROM ""
WHERE length(file.inlinks) = 0
AND length(file.outlinks) = 0
SORT file.name ASC
```

⑥ 日历打卡视图

```dataview
CALENDAR date
FROM "Daily"
```

⑦ 高评分书单

```dataview
TABLE author, rating, finish_date
FROM #读书笔记
WHERE rating >= 4
SORT rating DESC
```

⑧ 按状态分组项目

```dataview
TABLE rows.file.link
FROM "Projects"
GROUP BY status
```
DataviewJS 进阶:项目统计看板
DataviewJS — 动态统计
```dataviewjs
// 统计各状态项目数量
const pages = dv.pages('"Projects"');
const groups = {"计划中":0, "进行中":0, "已完成":0, "搁置":0};
for (let p of pages) {
  if (p.status && groups[p.status] !== undefined) groups[p.status]++;
}
dv.header(3, "📊 项目状态统计");
dv.table(["状态","数量"], Object.entries(groups));

dv.header(3, "🚀 进行中项目");
const active = pages.where(p => p.status === "进行中");
dv.table(
  ["项目","优先级","截止日期"],
  active.map(p => [p.file.link, p.priority ?? "未设置", p.deadline ?? "未定"])
);
```
⚠️
常见报错速查
· "No results to show" → 检查 FROM 路径大小写,检查 WHERE 字段名是否与 Front Matter 完全一致
· 日期比较失效 → Front Matter 中日期格式必须是 YYYY-MM-DD,不要加引号
· 某列不显示 → 字段名不能有空格,用下划线:start_date 而非 start date
· TABLE 中文乱码 → 确认字段名为英文,显示别名用:TABLE cn_field AS "中文显示名"
⚙️
CHAPTER 09
完整工作流设计方案
四种典型场景,从零搭建完整工作流
📚 工作流一:读书知识管理系统
  • 发现好书:Readwise 或浏览器剪藏器保存书籍信息 → 自动同步到 Obsidian 待读列表
  • 创建读书笔记:QuickAdd → "新建读书笔记" → 自动套用模板,Book Search 插件一键填充书籍元信息
  • 阅读中记录:边读边记,直接引用原文(引用块 >),加上自己的思考,用 [[双链]] 连接已有概念
  • 读完后提炼:写"永久笔记",用自己的语言总结书中核心观点(≠复述),链接回书籍笔记
  • 系统索引:在"阅读总览"笔记中用 Dataview 自动生成全部书单表格(状态/评分/完成日期)
🚀 工作流二:GTD 个人任务管理
  • 收集(Capture):想法/任务出现时 → QuickAdd Capture → 快速追加到 Inbox.md,不打断当前工作
  • 处理(Clarify):每天早上处理 Inbox,判断是可执行任务/信息/参考资料,分配到对应项目文件夹
  • 组织(Organize):Tasks 插件 + 日记模板 → 今日任务清单;Kanban 看板可视化项目进度
  • 回顾(Review):每日夜间日记回顾;每周日 Periodic Notes 创建周记,Dataview 汇总本周完成情况
  • 执行(Engage):打开每日笔记,今日任务一目了然,专注逐一完成
💼 工作流三:动态知识库首页仪表盘
🏠 首页.md — 动态仪表盘
## ☀️ 今日概览

### 📌 今日任务
```tasks
not done
scheduled on today
```

### 🚀 进行中项目
```dataview
TABLE status, deadline FROM "Projects"
WHERE status = "进行中" SORT deadline ASC
```

### 📝 最近修改笔记
```dataview
LIST FROM "" SORT file.mtime DESC LIMIT 8
```

### 📊 知识库概况
```dataviewjs
const total = dv.pages('""').length;
dv.paragraph(`📝 共 **${total}** 篇笔记`);
```
⌨️
CHAPTER 10
快捷键完整速查表
40+ 快捷键分类整理,Windows / macOS 完整对照
💡
自定义快捷键设置→快捷键,搜索任意功能名称,点击"+"添加自定义快捷键。强烈建议为"打开日记"、"插入模板"、"插入日期时间"等高频操作设置专属快捷键。

文件与导航

功能Windows/LinuxmacOS
新建笔记Ctrl+N⌘N
快速切换文件(模糊搜索)Ctrl+O⌘O
全局搜索Ctrl+Shift+F⌘⇧F
命令面板(最重要!)Ctrl+P⌘P
文件内搜索Ctrl+F⌘F
关闭当前标签Ctrl+W⌘W
切换上/下标签Ctrl+Tab / Ctrl+Shift+Tab⌘Tab
返回/前进历史Alt+← / Alt+→⌘[ / ⌘]
打开设置Ctrl+,⌘,

编辑操作

功能Windows/LinuxmacOS
粗体 / 斜体Ctrl+B / Ctrl+I⌘B / ⌘I
插入链接Ctrl+K⌘K
切换编辑/阅读模式Ctrl+E⌘E
撤销 / 重做Ctrl+Z / Ctrl+Y⌘Z / ⌘⇧Z
按词跳转光标Alt+←→⌥←→
按词选择文本Alt+Shift+←→⌥⇧←→
上/下移动当前行Alt+↑↓⌥↑↓
折叠/展开当前标题命令面板搜"折叠"同左
打开属性面板Ctrl+;⌘;

界面与视图

功能Windows/LinuxmacOS
显示/隐藏左侧边栏Ctrl+\⌘\
显示/隐藏右侧边栏Ctrl+Shift+\⌘⇧\
放大/缩小字体Ctrl++ / Ctrl+-⌘+ / ⌘-
导出为 PDF文件菜单 → 导出为PDF同左
CHAPTER 11 · 新增
进阶技巧与 CSS 美化
高手才知道的隐藏技巧 + 即用型 CSS 代码片段
🎯
命令面板是灵魂
Ctrl+P 是最重要的快捷键。任何不知道怎么操作的功能,先开命令面板搜索,95% 的功能都能找到。
🏷️
嵌套标签多维分类
使用 #技术/Python/爬虫 实现多层嵌套标签,在标签面板展开折叠,比文件夹更灵活,一篇笔记可以有多个维度的标签。
📌
图片宽度精细控制
![[图片.png|500]] 中 | 后的数字是宽度(px),|500x300 同时控制宽高。让长图不至于撑满整个页面。
🔗
别名系统
Front Matter 设置 aliases: [别名1, 别名2],输入双链时别名也能被搜索到,解决一个概念多种叫法的问题。
QuickAdd 宏命令
QuickAdd 的 Macro 功能可以组合多步骤为一键操作:如"一键创建项目"= 新建文件夹 + 创建笔记 + 套模板 + 打开笔记,一气呵成。
🔄
版本控制与备份
安装 Obsidian Git 插件,配置自动定时 commit 推送到 GitHub 私有仓库。免费且有完整版本历史,可回退任意历史版本。
CSS 代码片段(保存到 .obsidian/snippets/ 后启用)

① 宽页面(配合 cssclasses: wide-page)

/* 宽页面笔记布局 */
.wide-page .cm-contentContainer,
.wide-page .markdown-preview-section {
  max-width: 92% !important;
}

② 彩色文件夹标识

/* 特定文件夹名着色 */
.nav-folder-title[data-path="Projects"] {
  color: #fb7185 !important;
}
.nav-folder-title[data-path="Daily"] {
  color: #34d399 !important;
}

③ 已完成任务样式

/* 任务完成后灰化 */
.task-list-item.is-checked {
  opacity: 0.45;
  text-decoration: line-through;
}

④ 引用块样式增强

/* 更美观的引用块 */
blockquote {
  border-left: 3px solid var(--accent);
  background: rgba(124,92,191,.06);
  border-radius: 0 8px 8px 0;
  padding: 10px 16px;
}
🎨
2026年推荐主题(Top 4)
· Minimal:极简风格,配合 Minimal Theme Settings 插件高度可定制,最适合专注写作
· Blue Topaz:中文社区最受欢迎,功能全面,配合 Style Settings 插件
· AnuPpuccin:Catppuccin 柔和配色,护眼护美
· Everforest:绿色系护眼主题,长时间使用不疲劳
安装:设置→外观→主题→管理→浏览→搜索名称→安装。
⚠️
CHAPTER 12 · 新增
10大常见误区与避坑指南
汇总新手最容易踩的坑,附正确做法逐一解析
❌ 误区一:一开始就追求"完美系统"
错误:花大量时间研究 PARA / Zettelkasten / 插件配置,一个字都没写就已经折腾了几个小时
✅ 正确:先用起来,先随便写!从最简单的笔记开始,等你真正感到"不方便"时,再引入对应解决方案。复杂度应自然生长,而非预先设计。
❌ 误区二:把知识库放在 OneDrive/iCloud 自动同步文件夹
错误:Vault 放在 C:\Users\用户名\OneDrive\文档\ 导致 .obsidian 配置文件冲突、笔记被锁定甚至丢失
✅ 正确:Vault 放在不被自动同步的路径(D:\MyVault),如需云同步请使用第14章的专项方案。
❌ 误区三:过度依赖文件夹,忽视双链
错误:把所有精力用在设计文件夹层级,笔记之间几乎没有 [[链接]],知识库变成了高级文件系统
✅ 正确:文件夹是可选的辅助工具,双链才是 Obsidian 的灵魂。养成习惯:每次写笔记主动思考"这和哪些已有笔记有关联?"并添加链接。
❌ 误区四:一篇笔记堆砌太多内容
错误:一篇笔记写了10个相关但不同的主题,导致难以被其他笔记精准引用
✅ 正确:原子化原则——每篇笔记只讲一件事,标题即核心论点。内容多时拆分为多篇,用 [[链接]] 或 ![[嵌入]] 组合显示。
❌ 误区五:大量复制粘贴代替真正学习
错误:收集大量网络内容、文章段落,以为"存进来了就是学会了",知识库越来越大但自己没有真正吸收
✅ 正确:只摘录精华,更重要的是用自己的话总结理解(才能真正内化)。永久笔记 = 用自己语言写的原创思考,而非别人内容的搬运。
❌ 误区六:安装太多插件,陷入"折腾循环"
错误:看到好插件就装,50+ 插件同时开启,启动慢、冲突频发,大量时间花在折腾插件而非记录知识上
✅ 正确:按需安装,遇到具体痛点再找插件解决。超过20个插件需仔细评估必要性,定期禁用不常用的插件。
❌ 误区七:Dataview 字段名不规范导致查询失败
错误:Front Matter 中字段名含空格("start date")、大小写不一致(Status/status 混用),导致 Dataview 查询不到数据
✅ 正确:字段名全部小写,用下划线代替空格(start_date),在模板中固定字段名并全库统一使用同一套命名。
❌ 误区八:不做任何备份
错误:认为本地文件很安全,从不备份,硬盘损坏或系统故障后多年积累的笔记付诸东流
✅ 正确:至少采用一种备份方案:① Git 定期推送 GitHub 私有仓库;② 定期手动拷贝到外置硬盘;③ Obsidian Sync(有版本历史)。3-2-1 备份原则:3份数据,2种介质,1份异地。
❌ 误区九:完全忽视"未链接的提及"功能
错误:只关注已建立的链接,不知道还有大量"提到了但没链接"的隐藏关联等待被发现
✅ 正确:定期查看右侧边栏的"未链接的提及"面板,将有价值的提及转化为 [[链接]],不断丰富知识网络的密度。
❌ 误区十:设计过于复杂的模板,无法坚持填写
错误:日记模板有20个字段,每天光填模板就要15分钟,最终因太麻烦而放弃坚持
✅ 正确:模板只设计你确定每次都会填的字段,从3-5个字段开始,有需要再逐步添加。坚持记录 > 格式完美。
📱
CHAPTER 13 · 新增
移动端完整使用指南
iOS / Android 上的 Obsidian 安装、配置与使用技巧
📱
移动端基本情况Obsidian iOS/Android 客户端功能与桌面端高度一致,支持绝大多数插件,界面针对触摸屏优化,支持手势操作。移动端强项是随时随地快速捕获想法,弱项是长文本编辑。
1
iOS 安装与知识库配置
App Store 搜索 "Obsidian" 安装(免费)。

方案A — iCloud 同步(推荐 Apple 用户)
· 桌面端将 Vault 移动到 ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/
· iOS:打开 Obsidian → 创建知识库 → 选择"存储在 iCloud" → 选择已有文件夹
· iCloud 自动处理同步,无需额外工具

方案B — Obsidian Sync:订阅后全平台一键同步,最省心
2
Android 安装与同步配置
Google Play 或官网下载 .apk 安装。

方案A — Syncthing(免费首选)
· 电脑和手机都安装 Syncthing,将 Vault 文件夹添加为双向同步目录
· 局域网内同步飞快,完全免费,不依赖任何云服务

方案B — 坚果云 WebDAV
· 注册坚果云,在 Obsidian 移动端设置 → 第三方同步 → WebDAV,填入服务器地址和账号

方案C — Obsidian Git:自动推送到 GitHub,桌面端也安装同款插件
3
移动端效率技巧
iOS 快速捕获:在"快捷指令"App 中创建快捷方式,一键打开 Obsidian 并定位到日记,锁屏下也能快速记录

手势操作:左右滑动切换侧边栏;长按工具栏按钮可自定义;三指轻点可撤销输入

移动端推荐插件
· Advanced Mobile Toolbar:专为移动端设计的工具栏,添加常用 Markdown 按钮
· QuickAdd:配置好的快速捕获工作流在移动端同样有效
· Obsidian Git:自动定时同步到 GitHub

iPad 分屏:iPad 支持 Obsidian 与 Safari/文献应用分屏使用,边查资料边记笔记
4
移动端注意事项与局限
· 同步冲突风险:不要桌面和移动端同时编辑同一文件,会导致内容冲突
· 插件数量控制:移动端性能有限,超过20个插件会明显影响流畅度
· 大型附件:手机拍摄的照片体积大,建议设置附件路径并定期清理,或使用外部图床
· Excalidraw 等重型插件:移动端体验明显不如桌面端,仅作查看用途
☁️
CHAPTER 14
多端同步方案完整对比
六种方案详细横向对比,按需选择
方案费用难度可靠性隐私性推荐人群
Obsidian Sync$10/月极低极高+版本历史端对端加密有付费意愿,最省心
iCloud(iOS/macOS)免费中等苹果服务器纯 Apple 生态用户
Syncthing免费中等点对点无服务器注重隐私的技术用户
坚果云 WebDAV免费限速中等中等国内服务器国内用户免费方案
Git + GitHub免费较高高+完整历史私有仓库开发者,需要版本控制
Self-hosted LiveSync需服务器完全自控极度注重隐私+有服务器
🌟
场景推荐组合
· iPhone + Mac 用户:iCloud 同步,零配置成本
· Android + Windows 用户:Syncthing(局域网)+ Obsidian Git(远端备份)
· 有付费意愿:直接 Obsidian Sync,官方保障 + 版本历史 + 5端
· 开发者:Obsidian Git + GitHub 私有仓库,版本控制最完善
🔗
CHAPTER 15 · 新增
资源与社区大全
中英文学习资源、社区论坛、配套工具完整汇总
🌍 官方资源
  • 官方网站:obsidian.md — 下载、官方文档、订阅
  • 官方帮助文档:help.obsidian.md — 功能完整说明
  • 官方论坛:forum.obsidian.md — 英文主社区
  • 插件市场:obsidian.md/plugins — 全部 2000+ 社区插件
  • 主题市场:obsidian.md/themes — 全部主题浏览
🇨🇳 中文社区
  • Obsidian 中文论坛:forum-zh.obsidian.md — 最活跃的中文社区,下载包也在这
  • PKMer:pkmer.cn — 最全中文 Obsidian 教程和插件文档
  • 咖啡豆文档:obsidian.vip — Dataview/Templater 中文详细教程
  • 少数派:sspai.com 搜"Obsidian" — 大量实战经验文章
  • 知乎:搜"Obsidian" — 工作流分享、问答
🎬 视频教程
  • 咖啡豆(B站):中文 Obsidian 视频教程,Dataview 专项最详细
  • 少数派(B站):搜"少数派 Obsidian",工作流实战
  • Nick Milo(YouTube):LYT Framework 方法论原创作者
  • Bryan Jenks(YouTube):Zettelkasten + Obsidian 最佳实践
  • No Boilerplate(YouTube):技术向,Obsidian 进阶用法
🛠️ 配套生态工具
  • Readwise Reader:网络阅读高亮 → 自动同步 Obsidian
  • Zotero:学术文献管理,配合 Citations 插件导入
  • Syncthing:免费开源文件同步(Android最优方案)
  • Obsidian Web(Chrome扩展):浏览器一键剪藏到 Obsidian
  • obsidian-export:将 Obsidian 笔记导出为标准 Markdown
🚀
快速上手成长路线图
第1周:完成安装配置 → 不装插件 → 先写几篇笔记感受节奏,养成写作习惯
第2-3周:开启日记插件 → 每日记录 → 主动添加少量 [[链接]]
第1个月:安装 Calendar + Templater,建立日记模板,设计基础文件夹结构
第2个月:安装 Dataview,创建阅读列表或项目看板,体验数据化管理
第3个月+:根据个人痛点扩展工作流(QuickAdd / Kanban / Spaced Repetition 等)

记住:最好的系统 = 你能持续使用的系统,而非设计最精妙的系统。