Obsidian 教程

Obsidian 教程

Obsidian 是一款本地优先的 Markdown 笔记软件,以"双向链接"和"知识图谱"著称,是个人知识管理(PKM)和第二大脑的代表工具。

核心特性

  • 本地存储:笔记以 Markdown 文件保存在本地,数据自主可控
  • 双向链接:[[]] 语法建立笔记关联,自动生成反向链接
  • 知识图谱:可视化笔记间的关联网络
  • 插件生态:数百款社区插件,无限扩展能力
  • 免费:个人使用完全免费

典型用途

  • 个人知识库管理(Zettelkasten 卡片盒笔记法)
  • 学习笔记与课程整理
  • 写作与创作(支持发布)
  • 任务管理与项目记录
  • 日记与晨间笔记

学习路线

  1. 安装与第一个仓库
  2. Markdown 基础
  3. 双链与知识图谱
  4. 文件组织与插件
  5. 工作流、同步与进阶(Claude Code 集成、Web Clipper)

Obsidian 简介

Obsidian 简介

1. 发展历史

2020 年 发布(由 Dynalist 团队开发)
2021 年 上线插件市场
2022 年 推出 Obsidian Publish/同步服务
2024 年 发布 1.x,持续迭代

# 名称来自科幻小说《奥比斯》
# 强调"知识网络"理念

2. 核心理念

# 1. 本地优先
# 笔记是纯文本 Markdown,永远属于你

# 2. 双向链接
# 用 [[链接]] 连接想法,形成网络而非文件夹

# 3. 图谱视角
# 从整体看到知识的关联结构

# 4. 可扩展
# 插件 + CSS 主题 + API

3. 与同类工具对比

工具存储特点
Obsidian本地 Markdown双链、图谱、插件多
Notion云端数据库、协作强
Roam Research云端双向链接先驱,付费
Logseq本地大纲式,开源
Typora本地写作专注,无知识管理

4. 适用人群

  • 知识工作者(研究、学习、写作)
  • 开发者(技术笔记、文档)
  • 学生(课程笔记、知识整理)
  • 作家(素材库、灵感管理)

Obsidian 安装

Obsidian 安装

1. 下载安装

# 官网下载
# https://obsidian.md/download

# 支持平台
Windows / macOS / Linux
iOS / Android(移动端免费)

# 安装后启动,进入欢迎页

2. 创建仓库(Vault)

# 仓库 = 一个本地文件夹,存放所有笔记

# 方式一:创建新仓库
Open folder as vault → Create new vault
输入名称与位置

# 方式二:打开已有文件夹
Open folder as vault → 选择文件夹

# 仓库结构示例
my-vault/
├── .obsidian/        # 配置(自动生成)
├── 00-收件箱/
├── 10-项目/
├── 20-领域/
├── 30-资源/
└── 99-模板/

3. 界面布局

# 核心区域
左侧边栏    文件列表、搜索、图谱
中间面板    笔记编辑区(可多标签)
右侧边栏    反向链接、大纲、属性

# 快捷键
Ctrl+N    新建笔记
Ctrl+O    快速切换
Ctrl+E    编辑/阅读模式切换
Ctrl+P    命令面板
Ctrl+F    搜索

4. 基础设置

# 设置 → 编辑器
默认编辑模式: 源码/实时预览
行宽: 舒适阅读
严格换行: 开

# 设置 → 文件与链接
新笔记默认路径: 收件箱
新建笔记格式: 文件名.md

# 设置 → 外观
主题: 浅色/深色/自定义
字体: 自定义

Obsidian 第一个仓库

Obsidian 第一个仓库

1. 创建第一篇笔记

# 新建笔记
Ctrl+N 或点击"新建笔记"

# 输入内容
---
title: 我的第一篇笔记
date: 2026-08-18
tags: [obsidian, 入门]
---

# 欢迎来到 Obsidian!

这是我的**第一篇笔记**,使用 Markdown 语法。

## 为什么要用 Obsidian?
- 本地存储,数据安全
- 双向链接,知识网络
- 插件扩展

## 相关笔记
- [[Markdown 基础]]
- [[Obsidian 双链与知识图谱]]

2. 熟悉编辑

# 实时预览
Ctrl+E 切换 编辑/阅读 模式

# 常用操作
[[]]    插入双链
Ctrl+K  插入链接
Ctrl+B  加粗
Ctrl+I  斜体

# 搜索
Ctrl+Shift+F  全文搜索

3. 建立知识结构

# 建议初始结构
00-收件箱/         临时想法
10-项目/           进行中项目
20-领域/           长期关注领域
30-资源/           参考资料
40-归档/           已完成内容
99-模板/           模板文件

# 创建模板(99-模板/日记模板.md)
---
date: {{date}}
---
# {{date}}
## 今日要事
- [ ] 
## 记录

4. 日常使用流程

1. 捕获:临时想法写进收件箱
2. 整理:定期归档到对应分类
3. 链接:相关笔记建立 [[双链]]
4. 回顾:通过图谱/搜索定期回顾

Markdown 基础

Markdown 基础

1. 标题与文本

# 一级标题
## 二级标题
### 三级标题

**加粗文本**
*斜体文本*
***加粗斜体***
~~删除线~~
`行内代码`

> 引用内容
> 多行引用

---(分隔线)

2. 列表

# 无序列表
- 项目一
- 项目二
  - 子项目
    - 孙项目

# 有序列表
1. 第一步
2. 第二步
3. 第三步

# 任务列表
- [ ] 待办
- [x] 已完成
- [ ] 进行中

3. 链接与图片

# 外部链接
[百度](https://www.baidu.com)

# 内部链接(Obsidian 核心)
[[笔记名称]]
[[笔记名称|自定义显示]]
[[笔记名称#标题|跳到标题]]

# 图片
![alt 文字](https://example.com/image.png)

# 嵌入其他笔记
![[笔记名称]]

4. 代码块

```python
def hello():
    print("Hello, Obsidian!")
```

```javascript
// 支持语法高亮
const x = 42;
```

```mermaid
graph TD
    A[开始] --> B{判断}
    B -->|是| C[处理]
    B -->|否| D[结束]
```

5. 表格与高级语法

# 表格
| 功能 | 快捷键 |
|------|--------|
| 新建 | Ctrl+N |
| 搜索 | Ctrl+F |

# 注释
%% 这是 Obsidian 注释,不显示 %%

# 折叠
> [!note] 提示
> 这是 callout 提示框

> [!warning] 警告
> 注意内容

# 脚注
这是一个示例[^1]
[^1]: 脚注内容

Obsidian 双链与知识图谱

Obsidian 双链与知识图谱

1. 双向链接

# 创建链接
[[Python]]
[[Python|Python 语言]]
[[Python#基础语法]]

# 自动补全
# 输入 [[ 自动弹出笔记搜索

# 未创建笔记的链接(红色链接)
# 点击即可创建新笔记

2. 反向链接

# 右侧面板显示"反向链接"
# 列出所有链接到当前笔记的其他笔记

# 相当于
A 链接到 B → B 的反向链接中有 A

# 用处
- 发现相关笔记
- 追踪知识关联
- 自动建立知识网络

3. 知识图谱

# 打开图谱(左侧边栏图标)

# 图谱视图
- 节点:笔记
- 连线:双链关系
- 颜色:可配置(按标签/文件夹)

# 图谱设置
过滤器: 排除特定路径/标签
分组: 按文件夹/标签着色
显示: 标签/附件

# 局部图谱
# 笔记页内嵌入图谱
```query
```

4. Zettelkasten 卡片盒法

# 核心原则
1. 原子性:一个想法一张卡片
2. 用自己的话:转述而非摘抄
3. 建立链接:每张卡片至少链接一个相关想法
4. 链接优于层级

# 实践
- 每张笔记一个核心概念
- 用 [[链接]] 连接相关概念
- 通过图谱看到知识网络

5. 双链最佳实践

  • 链接用有意义的笔记名
  • 用别名处理一词多义(如 [[Python|Python 语言]])
  • 定期图谱回顾,清理孤立笔记
  • 主题笔记(MOC)作为入口组织链接

Obsidian 文件组织与管理

Obsidian 文件组织与管理

1. 文件夹结构

# PARA 方法
Projects     项目(有目标有期限)
Areas        领域(长期维护)
Resources    资源(参考资料)
Archives     归档(不活跃)

# 或按主题
技术 / 生活 / 工作 / 学习

# 数字前缀排序
00-收件箱
10-笔记
20-项目
30-资料

# 建议:文件夹不要太深(2-3 层)

2. 标签系统

# 行内标签
#技术 #python #todo

# 属性标签(frontmatter)
---
tags: [技术, python]
---

# 标签 vs 文件夹
文件夹: 组织归属
标签: 多维属性

# 标签使用建议
- 用层级标签 #编程/Python
- 控制标签数量
- 与双链互补

3. 属性(Frontmatter)

---
title: 笔记标题
created: 2026-08-18
tags: [技术]
status: 完成
author: 张三
---

# 属性面板
# 右侧面板可视化编辑

# 属性用途
- 元数据管理
- 配合 Dataview 插件查询
- 模板变量

4. 搜索与筛选

# 基础搜索
#python 关键词

# 高级搜索
file:笔记名       文件名
path:文件夹      路径
tag:#todo         标签
line:(关键词)    行内
task:""          任务

# 组合
tag:#todo AND 重要
path:项目 -tag:#归档

5. 文件操作技巧

# 移动
拖动到左侧文件夹,自动更新链接

# 重命名
重命名后所有引用自动更新

# 批量操作
# 配合插件或命令行

# 附件管理
设置 → 文件与链接 → 附件默认文件夹
建议: 每个笔记单独附件文件夹

Obsidian 插件

Obsidian 插件

1. 插件类型

# 核心插件(内置)
大纲、反向链接、标签页、模板
日记、录音、字数统计、图谱

# 社区插件(需启用)
设置 → 社区插件 → 浏览

# 安装步骤
1. 设置 → 社区插件
2. 关闭"安全模式"
3. 浏览并安装插件
4. 启用插件

2. 必装插件推荐

# 效率类
Dataview          数据查询与视图
Templater          模板引擎(高级)
QuickAdd           快速添加命令
Excalidraw         手绘/白板

# 增强类
Calendar           日历视图
Kanban             看板视图
Tasks              任务管理
Omnisearch         增强搜索

# 同步类
Remotely Save      远程同步(WebDAV)
Obsidian Git       Git 备份

# 写作类
Smart Connections  AI 知识关联
Copilot            AI 助手

3. Dataview 示例

```dataview
TABLE 状态, created, tags
FROM #项目
WHERE 状态 != "完成"
SORT created DESC
```

```dataview
LIST
FROM "30-资源"
WHERE contains(tags, "python")
```

# 统计未完成任务
```dataview
TASK
WHERE !completed
```

4. Templater 示例

# 模板文件(99-模板/读书笔记.md)
---
title: {{title}}
author: {{date:YYYY-MM-DD}}
tags: [读书]
---
# {{title}}
- 作者:
- 完成日期:
## 核心观点
## 摘录
## 感想

# 创建笔记时选择模板
# 或绑定快捷键

5. 插件管理技巧

  • 只装需要的插件,保持简洁
  • 插件配置随仓库保存(.obsidian)
  • 定期更新插件
  • 用插件配置文件同步多设备

Obsidian 工作流搭建

Obsidian 工作流搭建

1. 捕获工作流

# 灵感快速捕获
1. 快捷键 Ctrl+N 快速新建
2. 写入收件箱(默认位置)
3. 用 QuickAdd 插件一键入箱
4. 移动端快速记录

# 快速捕获配置(QuickAdd)
- 捕获: 新建笔记 → 收件箱
- 模板: 绑定常用模板

2. 整理工作流

# 每日整理(建议 10 分钟)
1. 打开收件箱
2. 逐条处理:
   - 有用 → 归档到对应文件夹
   - 关联 → 添加双链
   - 无用 → 删除
3. 更新相关笔记

# 周回顾
- 查看日记汇总
- 检查项目进度
- 更新图谱

3. 日记工作流

# 配置日记
设置 → 核心插件 → 日记
- 日期格式: YYYY-MM-DD
- 位置: 00-收件箱/日记
- 模板: 99-模板/日记模板

# 日记模板
---
date: {{date}}
---
# {{date}}
## 今日要事
- [ ]
## 完成
- 
## 思考
- 
## 明日
-

4. 项目管理工作流

# 项目笔记
---
type: project
status: 进行中
start: 2026-08-01
---
# 项目名称
## 目标
## 任务
- [ ] 
## 进展
## 相关
- [[相关笔记]]

# 用 Dataview 汇总项目
```dataview
TABLE 状态, start
FROM #项目
```

5. 完整流程闭环

捕获 → 整理 → 连接 → 回顾
  ↑                  |
  └────── 输出 ←─────┘

# 输出方式
- Obsidian Publish 发布网站
- 导出 PDF/Word
- 双链到博客文章
- 分享仓库

Obsidian 同步、备份与进阶技巧

Obsidian 同步、备份与进阶技巧

1. 同步方案

# 官方方案
Obsidian Sync(付费)
- 端到端加密
- 跨设备实时同步
- 版本历史

# 免费方案
1. Git 同步(Remotely Save / Obsidian Git)
   git init
   git add . && git commit -m "更新"
   git push origin main

2. WebDAV(Nutstore 坚果云)
   坚果云 → WebDAV 地址
   Remotely Save 插件配置

3. iCloud(Apple 设备)
   仓库放在 iCloud Drive

4. 移动端
   SyncTerra / Folder Sync

2. 备份策略

# 3-2-1 备份原则
3 份副本 / 2 种介质 / 1 份异地

# 实践
1. 本地仓库(工作副本)
2. Git 远程(私有仓库)
3. 云盘定期压缩备份

# 自动化
# Obsidian Git 插件自动提交
# 或 cron 定时备份
0 2 * * * cd ~/vault && git add -A && git commit -m "auto" && git push

3. 性能优化

# 大仓库优化
- 控制附件大小(图片压缩)
- 使用图片尺寸占位
- 图谱过滤大量节点
- 关闭不必要的核心插件

# 搜索优化
- 使用 Omnisearch 插件
- 控制标签数量
- 避免超长笔记

4. CSS 定制

# 外观 → 管理样式 → 新建片段

/* 自定义字体 */
body {
    font-family: "PingFang SC", sans-serif;
}

/* 标题颜色 */
h1 { color: #2c3e50; }
h2 { color: #34495e; }

/* 双链样式 */
.internal-link {
    color: #3498db;
    text-decoration: none;
}

/* 标签胶囊 */
.tag {
    background: #ecf0f1;
    border-radius: 4px;
    padding: 2px 6px;
}

5. 进阶技巧

# 1. 模板系统
# 用 Templater 绑定复杂逻辑

# 2. 每日笔记自动化
# QuickAdd + Templater 组合

# 3. 双链批量处理
# 用控制台命令或脚本

# 4. 知识输出
# Publish 发布 / 导出 PDF
# 用 pandoc 转 docx

# 5. 数据安全
# 定期验证 Git 历史完整

Obsidian + Claude Code

Obsidian + Claude Code

1. 组合思路

把 Obsidian 的知识库与 Claude Code 的 AI 能力结合,实现笔记自动整理、知识问答、内容生成等工作流。

2. Claude Code 读取笔记

# Claude Code 直接操作仓库文件
# 仓库即文件夹,AI 可读取、搜索、修改

# 典型用法
"帮我从知识库中找出所有关于 Python 的笔记"
"总结 30-资源 文件夹下的学习资料"
"根据我的读书笔记生成一篇博客文章"

# 搜索
grep -r "Python" ~/vault --include="*.md"
# 或让 AI 用 Grep 工具

3. 自动整理工作流

# 1. 收件箱清理
# 提示词示例:
"请扫描 00-收件箱 中的所有笔记,
按内容主题归类到 10-项目/20-领域/30-资源,
并在笔记间建立合适的双链"

# 2. 双链补全
"分析我的笔记库,为孤立的笔记
找到相关笔记并添加双向链接"

# 3. 笔记质量检查
"检查我的笔记,找出信息不完整的笔记
并给出补充建议"

4. 内容生成

# 从笔记生成文档
"根据 [[项目-A]] 和 [[技术总结]] 的笔记,
写一份项目周报(Markdown)"

# 批量格式化
"把 10-项目 下所有笔记统一格式:
补充 frontmatter(created/status/tags)"

# 摘要与回顾
"汇总本周日记的关键事件和思考,
生成周回顾笔记"

5. 注意事项

# 1. 版本控制
# 大规模修改前先 git commit 备份

# 2. 逐批操作
# 让 AI 每次处理少量文件并汇报

# 3. 双链检查
# 修改后验证 [[链接]] 未破坏

# 4. 人工审核
# AI 整理结果需人工确认再提交

# 5. 隐私
# 笔记内容敏感,使用本地模型或注意数据

Obsidian Web Clipper

Obsidian Web Clipper

1. 什么是 Web Clipper

Web Clipper 是 Obsidian 官方浏览器扩展,把网页内容一键保存为笔记,是"捕获"环节的重要工具。

2. 安装

# 浏览器扩展
Chrome/Edge: 搜索 "Obsidian Web Clipper"
Firefox: AMO 商店搜索

# 前提
# 需要 Obsidian 桌面端或同步服务

3. 基本使用

# 保存网页
1. 打开要保存的网页
2. 点击扩展图标
3. 预览裁剪内容(选择区域)
4. 选择目标仓库/文件夹
5. 点击保存

# 保存的内容
标题、正文、图片、链接
原始 URL、作者、时间

4. 高级配置

# 模板(扩展设置中配置)
---
title: {{title}}
source: {{url}}
date: {{date}}
author: {{byline}}
tags: [web-clip]
---
{{content}}

# 变量
{{title}}  页面标题
{{url}}    原始链接
{{date}}   保存日期
{{byline}} 作者
{{content}} 正文内容

# 自定义选择器
# 针对特定网站指定抓取区域

5. 知识库整合建议

# 1. 保存路径
Web Clips/ 或 30-资源/Web/

# 2. 保存后处理
- 阅读后写摘要
- 提取核心观点建卡片
- 删除不重要的剪辑

# 3. 防内容过载
- 只保存真正需要的
- 定期清理无效剪辑
- 用标签标记待读/已读
第 1 / 12 节