Obsidian 插件完整指南#

1. Claudian v2.0.34#

核心能力:

• 🤖 多模型 AI 助手（Claude Opus/Sonnet/Haiku/Fable）
• 📂 Vault 级文件操作：读取、编辑、创建，精确到行号
• 🔗 笔记上下文感知：可读取当前笔记、链接笔记、编辑器选中内容
• 🖥️ Bash 终端：在 vault 内执行 shell 命令
• 🌐 网页内容读取：可获取 Obsidian 内置浏览器中选中的网页内容
• 🔧 多步骤编排：跨文件重构、批量操作、自动化流程

典型用法:

• 代码审查、Bug 修复
• 知识整理、批量文档生成
• 图表绘制（搭配 Excalidraw 技能）
• Vault 自动化管理

2. Excalidraw v2.25.3#

核心能力:

• ✏️ 手绘风格/干净线条矢量图：流程图、架构图、思维导图
• 🔗 元素 ↔ 笔记双向链接
• 📝 图表内嵌入 Markdown 笔记内容
• 🎨 丰富元素：形状、箭头、图片、自由绘图、文本
• 📜 脚本引擎：自动生成/修改图表元素
• 🖼️ 导出 PNG/SVG/Excalidraw JSON
• 🔲 4D 无限画布（缩放+旋转+嵌套）

典型用法:

• 系统架构、数据流图
• 头脑风暴草图
• 笔记可视化
• 搭配 .excalidraw 技能（如 Claude 模型梯级对比.excalidraw）

3. PDF++ v0.40.31#

核心能力:

• 🖊️ 多色高亮 + 下划线标注
• 📝 PDF 页面批注/评论
• 🔗 标注 → Obsidian 笔记双向链接
• 📋 摘录引用：选中段落一键生成引用块
• 🔍 PDF 全文本搜索
• 📊 标注集中管理面板

典型用法:

• 论文/电子书深度阅读
• 文献摘录 → 知识库
• 学习笔记与原文对照

4. Calendar v1.5.10#

核心能力:

• 📅 右侧面板嵌入月历
• 🔵 有日记的日期自动标记圆点
• 📊 年度活动热力图
• ⏪ 周历模式切换

典型用法:

• 追踪每日写作习惯
• 快速跳转历史日记
• 写作频率可视化

5. Templater v2.20.6#

核心能力:

• 🔧 动态变量：<% tp.date.now() %>、<% tp.file.title %> 等
• 📜 JS 脚本：模板中可执行任意 JavaScript
• 📂 文件夹模板：指定文件夹自动套用
• ⚡ 触发模板：新建文件/日记时自动应用
• 🔄 命令调用：模板内触发 Obsidian 命令

与 Daily/日记模板.md 的配合: 模板中的 {{date:YYYY-MM-DD HH:mm}} 和 {{date:YYYY 年 MM 月 DD 日 dddd}} 由 Templater 自动替换为实际日期。

6. Recent Files v1.7.9#

核心能力:

• 📋 按时间倒序展示最近文件
• 🔍 从列表中快速跳转
• ⚙️ 可配置显示的条目数量

7. Local REST API with MCP v4.1.7#

核心能力:

• 🌐 REST API：程序化操作笔记、文件夹、标签
• 🔌 MCP 服务器：Claude Desktop / 外部 AI 直连 vault
• 🛡️ API Key / 证书双重认证
• 📡 实时 WebSocket 事件通知（文件变更、创建等）

典型用法:

• 自动化脚本（如 iOS 快捷指令写笔记）
• Claude Desktop 通过 MCP 读取知识库
• Raycast/Alfred 等效率工具集成

8. Better Export PDF v2.0.3#

核心能力:

• 👁️ 导出前实时预览
• 📑 基于标题层级自动生成 PDF 书签（大纲）
• 📄 自定义页眉/页脚（日期、文件名、页码）
• 🎨 可配置导出样式（字体、页边距、纸张大小）

9. Dataview v0.5.68 ✅#

核心能力:

• 📊 DQL：TABLE LIST TASK CALENDAR 四种视图
• 🔢 DataviewJS：JavaScript API 实现复杂自定义渲染
• 🏷️ 基于 frontmatter YAML + 内联字段 field:: value 过滤

快速上手:

1
```dataview
2
TABLE weather, mood
3
FROM "Daily"
4
SORT file.ctime DESC
5
LIMIT 7
6
```

10. Omnisearch v1.29.3 ✅#

核心能力:

• 🔍 拼错也能搜（pluggin → plugin）
• 🚀 打字即出结果，无需按回车
• 📄 索引 PDF 和图片中的文字
• 🏋️ 智能排序：标题匹配优先 + 修改时间加权

打开方式: Ctrl+P → Omnisearch: Open search，建议绑快捷键 Ctrl+Shift+O。

11. Notebook Navigator v3.2.3 ✅#

核心能力:

• 📂 文件夹树 + 🏷️ 标签浏览器双面板
• 👁️ 侧边预览（不打开笔记就能看到内容）
• ⌨️ 纯键盘操作（支持 Vim 风格快捷键）
• 📌 置顶收藏 + 拖拽排序

打开方式: 点击左侧边栏的 Notebook Navigator 图标（替换默认文件浏览器）。

12. Another Quick Switcher v14.7.0 ✅#

核心能力:

• 🔍 高级模糊匹配（比内置 Ctrl+O 更智能）
• 📂 最近文件快速回访
• 🏷️ 按标签过滤 + 🔗 按反向链接搜索
• ⭐ 与书签联动

打开方式: Ctrl+P → Another Quick Switcher: Open，建议替换默认 Ctrl+O 绑定。

13. Commander v0.5.7 ✅#

核心能力:

• 🔘 标题栏/状态栏/侧边栏添加自定义命令按钮
• 🧩 宏命令：组合多条命令一键触发
• 📱 移动端工具栏定制

快速上手: 设置 → Commander → 选择一个位置（如状态栏）→ Add Command → 选择常用命令（如 Git: Commit）。

14. Tasks v8.2.2#

Emoji 约定: 📅 截止 · ✅ 完成 · ⏫🔼🔽 优先级 · 🔁 重复 · 🛫 开始

启用后可在任意笔记中写:

1
```tasks
2
not done
3
due before next week
4
sort by priority
5
```

15. Git v2.38.6#

作者 Vinzent — 定时自动 commit+push，历史对比，冲突合并。适合需要版本控制的 vault。

16. Style Settings v1.0.9#

作者 mgmeyers — 主题 CSS 变量可视调节。与主题配合调整配色/字体/布局。

17. Terminal v3.26.0#

作者 polyipseity — 嵌入式终端面板，支持 PowerShell/Git Bash/WSL/CMD。

18. Tag Wrangler v0.6.4#

作者 PJ Eby — 批量重命名/合并标签。标签多了以后必备。

19. QuickAdd v2.12.3#

作者 Christian B. B. Houmann — 快速捕获想法、插入模板、宏命令。

20. File Explorer Note Count v1.2.4#

作者 Ozan Tellioglu — 文件夹旁显示笔记数量。

21. Advanced Canvas v6.5.0#

核心能力:

• 🎨 节点样式自定义（颜色、边框、圆角）
• ➕ 更多节点形状（圆形、菱形、云朵等）
• 🔗 连线样式增强
• 📐 对齐/分布辅助

22. Charts v3.9.0#

核心能力:

• 📊 支持柱状图、折线图、饼图、雷达图等
• 🎨 可自定义颜色和样式
• 📋 数据源支持 CSV 格式

快速上手:

1
```chartsview
2
type: bar
3
data:
4
  - label: 周一
5
    value: 12
6
  - label: 周二
7
    value: 19
8
```

Claudian — AI 助手#

🔹 打开方式

方式一：点击左侧边栏的 Claudian 图标（聊天气泡） 方式二：Ctrl+P → 搜索 Claudian → Open Chat

🔹 基本对话

在聊天框输入问题即可。Claudian 会自动读取当前打开的笔记作为上下文。

🔹 引用文件

在对话中用 @文件名 引用 vault 中的笔记，Claudian 会读取并理解其内容。例如：

1
@Obsidian 插件完整指南.md 帮我总结这份文档的核心要点

🔹 引用网页

在 Obsidian 内置浏览器中选中网页文字，然后在 Claudian 中说：

1
帮我翻译这段选中内容

🔹 执行多步骤任务

1
帮我：
2
1. 把 Daily/ 文件夹下所有日记的 weather 字段统计出来
3
2. 统计每种天气出现的天数
4
3. 生成一份汇总笔记

🔹 代码审查

打开代码文件，选中要审查的代码片段，然后说：

1
审查这段代码的安全性和性能问题

Excalidraw — 绘图#

🔹 创建新图

Ctrl+P → Excalidraw: Create new drawing，选择保存位置和文件名。

🔹 基本操作

🔹 嵌入到笔记

在 Markdown 笔记中用 “ 即可嵌入。嵌入后双击可以编辑。

🔹 配置样式

在 Excalidraw 设置中可调整默认字体、颜色主题、粗糙度等。

PDF++ — PDF 标注#

🔹 打开 PDF

将 PDF 文件放入 vault 任意位置，在 Obsidian 文件浏览器中点击即可打开。

🔹 高亮标注

选中 PDF 中的文字 → 弹出工具栏 → 选择颜色高亮。也可右键 → PDF++: Highlight selection。

🔹 添加批注

高亮后，点击高亮块旁边的 + 按钮添加文字批注。批注支持 Markdown。

🔹 摘录到笔记

选中文字 → 右键 → PDF++: Extract to new note → 自动创建笔记并建立双向链接。

🔹 查看所有标注

右侧面板 → PDF++ 标签 → 集中查看当前 PDF 的所有标注。

🔹 搜索 PDF 内容

Ctrl+Shift+F 全局搜索会自动索引 vault 中所有 PDF 的文本内容。

Calendar — 日历视图#

🔹 打开日历

右侧面板点击日历图标。如果没有，设置 → 核心插件 → 日记 → 开启，日历会自动关联 Daily Notes。

🔹 创建/打开日记

点击日历中的任意日期即可打开或创建当天日记。

🔹 切换视图

日历面板右上角切换月/周视图。底部显示年度活动热力图。

Templater — 高级模板#

🔹 创建模板文件

在 vault 中创建任意 .md 文件作为模板，使用 Templater 语法：

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

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

8
## 今天做了什么
9
-

🔹 设置 Daily Notes 模板

设置 → 核心插件 → 日记 → 模板文件 → 选择你的模板文件。 或者在 Templater 设置中：设置 → Templater → Folder Templates → 指定 Daily/ 文件夹使用日记模板。

🔹 常用变量速查

🔹 手动插入模板

Ctrl+P → Templater: Insert template → 选择模板文件。

Local REST API with MCP — 外部连接#

🔹 获取 API Key

设置 → Local REST API → Generate API Key。复制生成的 key 保存到安全位置。

🔹 测试连接

在命令行中（先获取 HTTPS 证书 fingerprint）：

1
# PowerShell 示例：读取今天的日记
2
Invoke-RestMethod -Uri "https://localhost:27124/Daily/" `
3
  -CertificateThumbprint "YOUR_CERT_FINGERPRINT" `
4
  -Headers @{"Authorization"="Bearer YOUR_API_KEY"}

🔹 Claude Desktop 连接（MCP 方式）

在 Claude Desktop 的 claude_desktop_config.json 中添加：

1
{
2
  "mcpServers": {
3
    "obsidian": {
4
      "command": "npx",
5
      "args": ["-y", "@anthropic-ai/mcp-server-obsidian"]
6
    }
7
  }
8
}

重启 Claude Desktop 后即可在对话中访问 vault 内容。

Better Export PDF — 导出 PDF#

🔹 导出当前笔记

打开任意笔记 → Ctrl+P → Better Export PDF: Export current note to PDF。

🔹 配置页眉页脚

设置 → Better Export PDF → Header & Footer → 自定义内容。可用变量：

🔹 预览模式

Ctrl+P → Better Export PDF: Export preview → 弹出预览窗口，确认后再导出。

Dataview — 数据查询#

🔹 基本查询

在任意笔记中插入 dataview 代码块：

1
```dataview
2
LIST
3
FROM "Daily"
4
WHERE mood = "开心"
5
SORT file.ctime DESC
6
```

渲染后自动显示所有符合条件的日记列表。

🔹 表格查询（最常用）

1
```dataview
2
TABLE weather, mood, file.ctime AS "日期"
3
FROM "Daily"
4
SORT file.ctime DESC
5
LIMIT 10
6
```

🔹 任务聚合

1
```dataview
2
TASK
3
FROM "Daily"
4
WHERE !completed
5
GROUP BY file.link
6
```

🔹 日历热力图

1
```dataview
2
CALENDAR file.ctime
3
FROM "Daily"
4
```

🔹 WHERE 常用条件

Tasks — 任务管理 ✨ 推荐启用#

🔹 创建任务

在任意笔记中用特定格式写任务：

1
- [ ] 写周报 📅 2026-07-22 ⏫
2
- [ ] 买牛奶 🛫 2026-07-17 🔁 every week
3
- [x] 完成复习 ✅ 2026-07-16

🔹 日期快捷键

在编辑任务时，用以下方式快速插入日期：

🔹 全局任务面板

在任意笔记中加入：

1
```tasks
2
not done
3
sort by due
4
```

这会自动列出 vault 中所有未完成任务，按截止日期排序。

🔹 常用过滤条件

Omnisearch — 全文搜索#

🔹 打开搜索

Ctrl+P → Omnisearch: Open search 或设置快捷键。

🔹 使用技巧

• 模糊搜索：拼错也能找到（如 pluggin 能找到 plugin）
• 快捷键过滤：搜索框内按 Ctrl+F 切换到文件搜索
• PDF 内容：启用后索引 vault 中所有 PDF 的文本
• 排除路径：在设置中可配置排除文件夹

Notebook Navigator — 增强文件浏览器#

🔹 打开方式

点击左侧边栏的 Notebook Navigator 图标（📓），替换默认文件浏览器。

🔹 双面板布局

左侧：文件夹树 → 浏览 vault 结构 右侧：标签列表 / 文件预览 → 多维度导航

🔹 键盘操作

🔹 置顶笔记

右键文件 → Pin to top → 常用笔记始终在最前面。

Another Quick Switcher — 增强文件切换#

🔹 替换默认 Ctrl+O

设置 → 快捷键 → 搜索 Another Quick Switcher → Open → 绑定 Ctrl+O（会覆盖核心插件的快速切换）。

🔹 搜索模式

打开后默认显示最近文件。输入搜索词后支持：

🔹 增强功能 vs 内置

Commander — 界面按钮定制#

🔹 添加按钮

设置 → Commander → 选择一个位置：

• 状态栏（底部）：适合常用小命令
• 标题栏（顶部）：适合宏命令
• 侧边栏（左侧）：适合面板开关

点击 Add Command → 搜索并选择命令（如 Git: Commit all changes）。

🔹 创建宏

Macros → New Macro → 添加多条命令 → 给宏起名 → 把宏按钮放到界面任意位置。

示例宏：「保存并提交」

1. Workspaces: Save and load layout
2. Git: Commit all changes
3. Git: Push

🔹 移动端

Commander 对手机/平板工具栏有专门优化——可隐藏/重排工具栏按钮。

Advanced Canvas — 增强白板#

🔹 创建白板

Ctrl+P → Canvas: Create new canvas，或右键文件夹 → New canvas。

🔹 增强节点类型

右键白板 → 除了默认矩形卡片，Advanced Canvas 新增：

• ⬜ 圆角卡片、🟠 圆形节点、🔷 菱形节点
• 📝 便签风格节点、☁️ 云朵形状

🔹 样式定制

选中节点 → 右侧属性面板：

• 背景色 / 边框色 / 边框宽度
• 圆角大小
• 透明度

🔹 对齐工具

多选节点 → 右键 → Align → 左对齐/居中/右对齐/顶对齐/等距分布。

Charts — 图表嵌入#

🔹 插入柱状图

1
```chartsview
2
type: bar
3
data:
4
  - label: 周一
5
    value: 12
6
  - label: 周二
7
    value: 19
8
  - label: 周三
9
    value: 8
10
width: 100%
11
height: 300
12
```

🔹 支持图表类型

🔹 自定义颜色

1
```chartsview
2
type: pie
3
colors:
4
  - "#3b82f6"
5
  - "#60a5fa"
6
  - "#93c5fd"
7
data:
8
  - label: 工作
9
    value: 40
10
  - label: 学习
11
    value: 25
12
  - label: 休息
13
    value: 35
14
```

🔹 搭配 Dataview 动态数据

可以先用 Dataview 聚合统计数据，再手动填入 Charts。未来可探索 DataviewJS → Charts 的联动。

Git — 版本控制#

🔹 首次设置

1. 终端中进入 vault 目录：cd "D:/ObsidianFirstNotes/Embedded Learning"
2. 初始化 Git：git init
3. 创建 .gitignore，排除 .obsidian/workspace.json 等敏感文件
4. 添加远程仓库：git remote add origin <你的仓库 URL>

🔹 配置自动备份

设置 → Git → Backup：

• Vault backup interval：设为 30（每 30 分钟自动 commit）
• Auto pull interval：设为 0 表示关闭
• 开启 Push on backup 自动推送到远程

🔹 手动操作

Tag Wrangler — 标签管理#

🔹 打开标签面板

左侧边栏 → 标签图标（或 Ctrl+P → Tag Wrangler: Open tag pane）。

🔹 重命名标签

在标签面板中右键某个标签 → Rename tag → 输入新名称。所有使用该标签的笔记会同步更新。

🔹 合并标签

右键标签 → Merge tag → 选择目标标签。此操作不可逆，会先弹出确认。

QuickAdd — 快速捕获#

🔹 创建捕获命令

设置 → QuickAdd → Manage Macros → 新建 → 选择 Template 类型 → 选择模板文件。

🔹 绑定快捷键

设置 → 快捷键 → 搜索 QuickAdd → 给你的捕获命令绑定 Ctrl+Shift+N 等快捷键。

🔹 快速添加想法

按快捷键 → 弹出输入框 → 输入内容 → 自动按模板创建笔记。

PDF++ — 快捷键速查#

每日写作流#

1
1. 打开 Obsidian → Calendar 面板 → 点击今天日期
2
2. 日记模板自动填充日期 → 填写 weather / mood
3
3. 在各板块中写作
4
4. Git 每 30 分钟自动备份

知识整理流#

1
1. PDF++ 打开文档阅读 → 高亮关键段落 → 摘录到笔记
2
2. 在笔记中用 Dataview 聚合近期高亮内容
3
3. 添加 #待整理 标签
4
4. 周末用 Tasks 筛选待整理任务统一处理

AI 辅助流#

1
1. 打开要处理的笔记
2
2. 右侧打开 Claudian 面板
3
3. 让 AI 总结、翻译、改写、扩写当前笔记
4
4. AI 可直接修改 vault 中的文件