📋 完整目录
⬡
💡
一句话定义Obsidian 是一款本地优先、基于纯 Markdown 的知识管理工具,以双向链接和关系图谱为核心,帮助你建立"第二大脑"。2020年创立,2026年2月宣布商业用途永久免费,社区插件超 2000 个。
🔒
本地优先,永不锁定
所有笔记以纯 .md 文件存储在本地,格式开放,软件停更笔记依然永久可用。
隐私安全🕸️
双向链接,知识成网
[[双括号]] 将笔记互联,不仅能看当前引用了谁,还能看谁引用了当前笔记(反向链接)。
核心功能🗺️
知识图谱,可视化
图谱视图将所有笔记渲染为动态星系图,直观展现知识全貌,发现意外关联。
可视化🧩
2000+ 社区插件
官方核心插件 + 社区 2000+ 插件,从简单编辑到 AI 辅助、项目管理应有尽有。
可扩展🆓
完全免费含商业
2026年2月官方宣布商业用途也免费,无需担心授权,企业团队也可放心使用。
永久免费🖥️
全平台覆盖
Win / macOS / Linux 桌面端 + iOS / Android 移动端,一个知识库多端访问。
跨平台与主流竞品深度对比
| 功能 | Obsidian | Notion | Roam Research | Logseq |
|---|---|---|---|---|
| 本地存储 | ✅ 纯本地 | ❌ 仅云端 | ❌ 仅云端 | ✅ 本地 |
| 双向链接 | ✅ 强力 | ⚡ 基础 | ✅ 核心 | ✅ 强力 |
| 标准Markdown | ✅ 完全支持 | ⚡ 有限 | ⚡ 定制语法 | ✅ 支持 |
| 插件数量 | ✅ 2000+ | ⚡ 有限 | ⚡ 较少 | ⚡ 中等 |
| 完整离线 | ✅ 完整 | ⚡ 有限 | ❌ 需联网 | ✅ 完整 |
| 免费程度 | ✅ 商业免费 | ⚡ 免费有限 | ❌ $15/月 | ✅ 开源免费 |
| 学习曲线 | 中等 | 较低 | 较高 | 中等 |
| 推荐人群 | 知识工作者/研究者 | 团队协作 | 网状笔记发烧友 | 大纲爱好者 |
⬇️
🇨🇳
国内用户特别提示官方服务器在海外,国内下载可能缓慢或中断。推荐从 Obsidian 中文论坛(forum-zh.obsidian.md)下载社区成员搬运的安装包,完全安全,版本与官方同步。插件市场同理,可通过 pkmer.cn 获取插件镜像。
1
选择平台并下载
访问 https://obsidian.md/download,根据系统选择:
Windows:推荐 Obsidian-x.x.x-user.exe(User Installer,无需管理员权限)
macOS Apple Silicon:Obsidian-x.x.x-arm64.dmg;Intel Mac:x86_64.dmg
Linux:推荐 .AppImage(通用)或 snap install obsidian --classic
iOS/Android:App Store / Google Play 搜索 "Obsidian" 官方应用(免费)
Windows:推荐 Obsidian-x.x.x-user.exe(User Installer,无需管理员权限)
macOS Apple Silicon:Obsidian-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 文件夹。若提示"无法验证开发者",进入 系统设置→隐私与安全→仍然允许打开。
macOS 注意:将 Obsidian.app 拖入 Applications 文件夹。若提示"无法验证开发者",进入 系统设置→隐私与安全→仍然允许打开。
3
创建第一个知识库(Vault)
知识库是所有笔记的根文件夹,所有 .md 文件都存于其中。
· 启动后点击 "新建知识库"
· 输入名称:如 MyVault(建议纯英文,避免路径问题)
· 选择路径:推荐 D:\MyVault(非系统盘,路径无中文无空格)
· 点击创建
· 启动后点击 "新建知识库"
· 输入名称:如 MyVault(建议纯英文,避免路径问题)
· 选择路径:推荐 D:\MyVault(非系统盘,路径无中文无空格)
· 点击创建
⚠️ 路径禁区:绝对不要将 Vault 放在 iCloud / OneDrive 自动同步文件夹内(如 C:\Users\用户名\OneDrive\...),会引发文件冲突和数据损坏。如需云同步,使用第14章专项方案。
4
切换中文界面
点击左下角 ⚙️ 设置图标 → General(通用) → Language 下拉框 → 选择 简体中文 → 点击 Relaunch(重启),完成语言切换。
5
初始化必做配置
设置 → 文件与链接:
· "新笔记的默认位置" → Inbox(先创建此文件夹)
· "附件默认保存位置" → Assets(统一管理图片附件)
· 开启"使用 Wiki 链接"
设置 → 编辑器:
· 默认编辑模式 → "实时预览(Live Preview)"
· 行宽 → "放宽"(避免文字过于拥挤)
设置 → 核心插件:开启 日记、模板、快速切换、标签列表、大纲、书签
· "新笔记的默认位置" → Inbox(先创建此文件夹)
· "附件默认保存位置" → Assets(统一管理图片附件)
· 开启"使用 Wiki 链接"
设置 → 编辑器:
· 默认编辑模式 → "实时预览(Live Preview)"
· 行宽 → "放宽"(避免文字过于拥挤)
设置 → 核心插件:开启 日记、模板、快速切换、标签列表、大纲、书签
🖥️
🗂️ 五大界面区域
- 左侧边栏:文件树、搜索、书签、标签面板、插件导航区
- 中央编辑区:笔记编辑主区,支持多标签页 + 分屏
- 右侧边栏:反向链接、大纲、属性、日历等面板
- 状态栏(底部):字数统计、行列信息、当前视图模式
- 命令面板:Ctrl+P 呼出,几乎所有功能均可在此搜索执行
✏️ 三种编辑模式
- 实时预览(Live Preview):所见即所得,输入语法即时渲染,日常首选
- 源码模式(Source Mode):显示纯 Markdown 代码,精细操控格式时使用
- 阅读模式(Reading View):完整渲染只读,适合整理好的文章查阅
- 快速切换:Ctrl+E 在编辑和预览间切换
①
创建、重命名、删除笔记
创建:Ctrl+N | 左侧文件区 "+" 图标 | 右键文件夹→新建笔记 | 输入 [[不存在的名称]] 点击自动创建
重命名:F2 | 双击标签页标题 | 右键文件→重命名。重命名时 Obsidian 自动更新全库所有指向该笔记的链接,无需手动查找替换。
删除:右键→删除,默认移入系统回收站(设置中可改为放入 .trash 文件夹)
重命名:F2 | 双击标签页标题 | 右键文件→重命名。重命名时 Obsidian 自动更新全库所有指向该笔记的链接,无需手动查找替换。
删除:右键→删除,默认移入系统回收站(设置中可改为放入 .trash 文件夹)
②
分屏与多窗格高效操作
方法一:按住 Ctrl 点击链接/文件 → 在新标签页打开
方法二:右键任意文件/链接 → "在新窗格中打开"
方法三:拖拽标签页到编辑区边缘,出现蓝色指示时松开 → 实现左右/上下分屏
方法四:命令面板搜索"分屏" → 执行垂直/水平分屏命令
实用场景:左侧写源码查看 Dataview,右侧阅读模式实时预览效果;左侧写作,右侧开大纲导航。
方法二:右键任意文件/链接 → "在新窗格中打开"
方法三:拖拽标签页到编辑区边缘,出现蓝色指示时松开 → 实现左右/上下分屏
方法四:命令面板搜索"分屏" → 执行垂直/水平分屏命令
实用场景:左侧写源码查看 Dataview,右侧阅读模式实时预览效果;左侧写作,右侧开大纲导航。
③
搜索系统完整指南
全局搜索 Ctrl+Shift+F:
· file:笔记名 仅搜文件名 | tag:#标签名 按标签搜索
· path:文件夹/ 限定路径 | /正则表达式/ 正则搜索
· line:内容 按行内容搜索 | content:关键词 全文搜索
快速切换 Ctrl+O:模糊搜索文件名快速跳转
文件内搜索 Ctrl+F:支持正则,区分大小写
· file:笔记名 仅搜文件名 | tag:#标签名 按标签搜索
· path:文件夹/ 限定路径 | /正则表达式/ 正则搜索
· line:内容 按行内容搜索 | content:关键词 全文搜索
快速切换 Ctrl+O:模糊搜索文件名快速跳转
文件内搜索 Ctrl+F:支持正则,区分大小写
④
属性(Properties)系统详解
v1.4 起提供图形化属性编辑界面,替代手写 YAML:
· 快捷键 Ctrl+; 或点击笔记顶部"+ 添加属性"打开
· 支持文本、数字、日期、复选框、列表等多种字段类型
· 属性值实时同步到文件 YAML Front Matter,Dataview 可直接查询
· 设置→属性 可管理全库属性类型定义
· v1.9 的 Bases 插件可像 Notion 数据库一样管理这些属性
· 快捷键 Ctrl+; 或点击笔记顶部"+ 添加属性"打开
· 支持文本、数字、日期、复选框、列表等多种字段类型
· 属性值实时同步到文件 YAML Front Matter,Dataview 可直接查询
· 设置→属性 可管理全库属性类型定义
· v1.9 的 Bases 插件可像 Notion 数据库一样管理这些属性
✍️
| 效果 | 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片段) --- 笔记正文从这里开始...
🕸️
| 链接类型 | 语法 | 效果与用途 |
|---|---|---|
| 基本内部链接 | [[笔记名]] | 链接到库内任意笔记,点击跳转,悬停+Ctrl预览 |
| 别名显示链接 | [[笔记名|显示文字]] | 显示别名,适合长名称笔记或保持文章流畅性 |
| 标题锚点 | [[笔记名#二级标题]] | 直接跳转到笔记内指定标题,输入#后Tab自动补全 |
| 段落块链接 | [[笔记名^blockid]] | 精确引用某段落,输入^后Tab自动生成唯一ID |
| 嵌入整篇 | ![[笔记名]] | 将整篇笔记内容内嵌显示,内容实时同步 |
| 嵌入标题段 | ![[笔记名#标题]] | 只嵌入指定标题下的内容 |
| 嵌入段落块 | ![[笔记名^blockid]] | 嵌入精确段落,适合构建汇总型笔记 |
↩️ 反向链接深度使用
- 打开方式:右侧边栏点击"反向链接"面板
- 已链接的提及:明确添加了 [[链接]] 的笔记列表
- 未链接的提及:提到了笔记名但尚未添加链接,可一键转换
- 定期检查未链接提及,不断丰富知识网络
- 一篇笔记的反向链接越多,说明它是越重要的"知识枢纽"
🗺️ 关系图谱使用技巧
- 全局图谱:左侧边栏图谱图标,展示全库网络
- 局部图谱:命令面板搜"局部关系图谱",只看当前笔记的关联
- 过滤:搜索框 + 过滤器,只显示特定标签或文件夹
- 颜色分组:按标签/文件夹给节点着色,区分知识类别
- 节点越大 = 链接越多 = 越重要的核心概念
- 双击节点直接打开该笔记
🗂️
📐
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,不要在创建时思考分类。等有整块时间(如每周一次)再统一整理。这是避免"分类焦虑"阻碍记录的关键策略。
🧩
🔧
安装社区插件(国内用户)设置→社区插件→关闭安全模式→浏览(需代理或用 PKMer 加速:pkmer.cn)。手动安装:下载 main.js、manifest.json 放入 .obsidian/plugins/插件ID/ 目录,重启后启用。
v1.8–1.9 重磅核心插件
🌐
网页浏览器(Web Viewer)— v1.8 新增
Obsidian 内置浏览器,可边查网页边记笔记,无需切换窗口。点击外部链接时选择"在浏览器中打开",完美融入工作流。
设置 → 核心插件 → 网页浏览器🗄️
Bases(数据集)— v1.9 重磅新增
类 Notion 数据库功能!基于 Front Matter 属性,支持表格/看板/画廊视图,可过滤、排序、分组,直接编辑属性值。创建方式:新建文件→选择"数据集(Base)"类型。比 Dataview 更直观,无需写查询语言,适合不喜欢代码的用户。
设置 → 核心插件 → Bases社区四大金刚(必装)
📊
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🎨 视觉美化类(4个)
🎨
Style Settings
图形界面调整主题颜色、字体、间距,无需手写 CSS,配合 Blue Topaz/Minimal 主题使用。
obsidian-style-settings🖼️
Banners
在笔记顶部添加横幅封面图,让笔记更有视觉感,支持本地文件或 URL 图片。
obsidian-banners📊
Charts
在笔记中创建折线图、柱状图、饼图等,数据直接写在 Markdown 代码块中。
obsidian-charts🧭
Map View
将笔记中的地理位置信息可视化为地图,适合旅行日记、地点记录、田野调查笔记。
obsidian-map-view📋
⚡
前置条件安装并启用 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") %>
- 项目启动
## 🔗 相关资料📊
⚙️
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 "中文显示名"
· "No results to show" → 检查 FROM 路径大小写,检查 WHERE 字段名是否与 Front Matter 完全一致
· 日期比较失效 → Front Matter 中日期格式必须是 YYYY-MM-DD,不要加引号
· 某列不显示 → 字段名不能有空格,用下划线:start_date 而非 start date
· TABLE 中文乱码 → 确认字段名为英文,显示别名用:TABLE cn_field AS "中文显示名"
⚙️
📚 工作流一:读书知识管理系统
- 发现好书: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}** 篇笔记`);
```⌨️
💡
自定义快捷键设置→快捷键,搜索任意功能名称,点击"+"添加自定义快捷键。强烈建议为"打开日记"、"插入模板"、"插入日期时间"等高频操作设置专属快捷键。
文件与导航
| 功能 | Windows/Linux | macOS |
|---|---|---|
| 新建笔记 | 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/Linux | macOS |
|---|---|---|
| 粗体 / 斜体 | Ctrl+B / Ctrl+I | ⌘B / ⌘I |
| 插入链接 | Ctrl+K | ⌘K |
| 切换编辑/阅读模式 | Ctrl+E | ⌘E |
| 撤销 / 重做 | Ctrl+Z / Ctrl+Y | ⌘Z / ⌘⇧Z |
| 按词跳转光标 | Alt+←→ | ⌥←→ |
| 按词选择文本 | Alt+Shift+←→ | ⌥⇧←→ |
| 上/下移动当前行 | Alt+↑↓ | ⌥↑↓ |
| 折叠/展开当前标题 | 命令面板搜"折叠" | 同左 |
| 打开属性面板 | Ctrl+; | ⌘; |
界面与视图
| 功能 | Windows/Linux | macOS |
|---|---|---|
| 显示/隐藏左侧边栏 | Ctrl+\ | ⌘\ |
| 显示/隐藏右侧边栏 | Ctrl+Shift+\ | ⌘⇧\ |
| 放大/缩小字体 | Ctrl++ / Ctrl+- | ⌘+ / ⌘- |
| 导出为 PDF | 文件菜单 → 导出为PDF | 同左 |
✨
🎯
命令面板是灵魂
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:绿色系护眼主题,长时间使用不疲劳
安装:设置→外观→主题→管理→浏览→搜索名称→安装。
· Minimal:极简风格,配合 Minimal Theme Settings 插件高度可定制,最适合专注写作
· Blue Topaz:中文社区最受欢迎,功能全面,配合 Style Settings 插件
· AnuPpuccin:Catppuccin 柔和配色,护眼护美
· Everforest:绿色系护眼主题,长时间使用不疲劳
安装:设置→外观→主题→管理→浏览→搜索名称→安装。
⚠️
❌ 误区一:一开始就追求"完美系统"
错误:花大量时间研究 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个字段开始,有需要再逐步添加。坚持记录 > 格式完美。
📱
📱
移动端基本情况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:订阅后全平台一键同步,最省心
方案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,桌面端也安装同款插件
方案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/文献应用分屏使用,边查资料边记笔记
手势操作:左右滑动切换侧边栏;长按工具栏按钮可自定义;三指轻点可撤销输入
移动端推荐插件:
· Advanced Mobile Toolbar:专为移动端设计的工具栏,添加常用 Markdown 按钮
· QuickAdd:配置好的快速捕获工作流在移动端同样有效
· Obsidian Git:自动定时同步到 GitHub
iPad 分屏:iPad 支持 Obsidian 与 Safari/文献应用分屏使用,边查资料边记笔记
4
移动端注意事项与局限
· 同步冲突风险:不要桌面和移动端同时编辑同一文件,会导致内容冲突
· 插件数量控制:移动端性能有限,超过20个插件会明显影响流畅度
· 大型附件:手机拍摄的照片体积大,建议设置附件路径并定期清理,或使用外部图床
· Excalidraw 等重型插件:移动端体验明显不如桌面端,仅作查看用途
· 插件数量控制:移动端性能有限,超过20个插件会明显影响流畅度
· 大型附件:手机拍摄的照片体积大,建议设置附件路径并定期清理,或使用外部图床
· Excalidraw 等重型插件:移动端体验明显不如桌面端,仅作查看用途
☁️
| 方案 | 费用 | 难度 | 可靠性 | 隐私性 | 推荐人群 |
|---|---|---|---|---|---|
| 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 私有仓库,版本控制最完善
· iPhone + Mac 用户:iCloud 同步,零配置成本
· Android + Windows 用户:Syncthing(局域网)+ Obsidian Git(远端备份)
· 有付费意愿:直接 Obsidian Sync,官方保障 + 版本历史 + 5端
· 开发者:Obsidian Git + GitHub 私有仓库,版本控制最完善
🔗
🌍 官方资源
- 官方网站: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 等)
记住:最好的系统 = 你能持续使用的系统,而非设计最精妙的系统。
第1周:完成安装配置 → 不装插件 → 先写几篇笔记感受节奏,养成写作习惯
第2-3周:开启日记插件 → 每日记录 → 主动添加少量 [[链接]]
第1个月:安装 Calendar + Templater,建立日记模板,设计基础文件夹结构
第2个月:安装 Dataview,创建阅读列表或项目看板,体验数据化管理
第3个月+:根据个人痛点扩展工作流(QuickAdd / Kanban / Spaced Repetition 等)
记住:最好的系统 = 你能持续使用的系统,而非设计最精妙的系统。