24 KiB
title, created, updated, tags, type
| title | created | updated | tags | type | ||||
|---|---|---|---|---|---|---|---|---|
| Obsidian 插件使用手册 | 2026-01-05 | 2026-01-05 |
|
reference |
Obsidian 插件使用手册
📅 更新时间:2026年1月5日 📊 插件总数:24个 📝 文档来源:插件 manifest、配置文件、官方文档
目录
快速导航
| 插件名称 | 主要功能 | 推荐指数 | 难度 |
|---|---|---|---|
| #Claudian | AI 聊天助手 | ⭐⭐⭐⭐⭐ | 简单 |
| #Templater | 动态模板系统 | ⭐⭐⭐⭐⭐ | 中等 |
| #Dataview | 数据查询视图 | ⭐⭐⭐⭐⭐ | 高级 |
| #Git | 版本控制备份 | ⭐⭐⭐⭐⭐ | 简单 |
| #Copilot | AI 写作助手 | ⭐⭐⭐⭐⭐ | 中等 |
| #Tasks | 任务管理系统 | ⭐⭐⭐⭐ | 中等 |
| #Excalidraw | 手绘图形工具 | ⭐⭐⭐⭐ | 简单 |
| #Easy Typing | 中文输入优化 | ⭐⭐⭐⭐ | 简单 |
| #Omnisearch | 增强搜索 | ⭐⭐⭐⭐ | 简单 |
| #Advanced Tables | 表格增强 | ⭐⭐⭐⭐ | 简单 |
插件分类
AI 增强类
- Claudian - Claude AI 侧边栏聊天
- Smart Connections - 语义相关笔记推荐
- Copilot - AI 助手、对话、总结
- MCP Tools - Claude Desktop 集成
编辑增强类
- Advanced Tables - 表格增强
- Easy Typing - 中文输入优化
- Code Styler - 代码美化
- Advanced Codeblock - 代码块增强
- CM CHS Patch - 中文分词支持
任务管理类
- Tasks - 任务跟踪系统
- Kanban - 看板视图
- Calendar - 日历视图
模板和自动化类
- Templater - 动态模板系统(详见 Templater-User-Guide)
搜索和导航类
- Omnisearch - 增强搜索
- Dataview - 数据查询和视图
可视化类
- Excalidraw - 手绘图形
- Mind Map - 思维导图
- Advanced Canvas - 画布增强
版本控制和备份类
- Git - 版本控制和自动备份
外观定制类
- Style Settings - CSS 变量调整
- Iconize - 图标管理
- Better Word Count - 字数统计
集成和扩展类
- Local REST API - REST API 接口
- Advanced URI - 高级 URI 链接
详细手册
AI 增强类
Claudian
版本:1.3.16 | 类型:桌面端专用
插件描述
将 Claude AI 嵌入为侧边栏聊天工具,具有完整的代理能力,支持文件操作和 bash 命令。
主要功能
- 🤖 在 Obsidian 侧边栏中直接与 Claude AI 对话
- 📁 支持文件读取和操作
- 💻 可执行 bash 命令
- 🎯 完整的 AI 助手代理功能
使用方法
- 点击侧边栏的 Claudian 图标打开 AI 聊天窗口
- 直接与 Claude 对话,询问笔记相关问题
- 可以让 Claude 帮助编辑、总结、创建笔记
使用场景
- 快速总结长篇笔记
- 辅助创建笔记大纲
- 询问 vault 中的知识问题
- 自动化文件管理任务
Smart Connections
版本:4.1.7 | 官网:https://smartconnections.app
插件描述
使用本地或远程 AI 模型与笔记对话,查看相关内容的智能链接。
主要功能
- 🔗 基于语义相似度查找相关笔记
- 💡 AI 驱动的笔记推荐
- 💬 与笔记内容智能对话
- 🖥️ 支持本地和远程 AI 模型
使用场景
- 发现笔记之间的隐藏联系
- 快速找到相关笔记
- 使用 AI 理解和总结笔记内容
Copilot
版本:3.1.4 | 作者:Logan Yang
插件描述
AI Copilot - 与你的"第二大脑"聊天,更快学习,更智能工作。
主要功能
- 💬 与笔记内容对话
- ✍️ AI 辅助写作
- 🔍 语义搜索
- 📝 笔记总结和理解
- 🤖 自主代理功能
- 🎯 自定义提示词
关键设置项
- 默认模型:Google Gemini 2.5 Flash(通过 OpenRouter)
- 嵌入模型:text-embedding-3-small
- 温度:0.1
- 最大 tokens:6000
- 上下文轮数:15
- 会话保存文件夹:
copilot/copilot-conversations - 自定义提示词文件夹:
copilot/copilot-custom-prompts
支持的 AI 模型
- Google Gemini 2.5 系列
- OpenAI GPT-4.1、GPT-5 系列
- Claude Sonnet 4
- DeepSeek Chat/Reasoner
- Grok 4
- 自定义模型(如 Kimi)
自主代理工具
- 📍 本地搜索
- 📖 读取笔记
- 🌐 网络搜索
- 🍅 番茄钟
- 📺 YouTube 转录
- 💾 写入文件
- ✏️ 替换文件内容
- 🧠 更新记忆
使用场景
- 询问笔记相关问题
- 总结长篇文章
- 生成大纲和想法
- 辅助写作和润色
- 语义相关笔记推荐
MCP Tools
版本:0.2.27 | 类型:桌面端专用 | 作者:Jack Steam
插件描述
安全地将 Claude Desktop 连接到你的 vault,提供语义搜索、模板和文件管理能力。
主要功能
- 🔌 Claude Desktop 集成
- 🔍 语义搜索
- 📋 模板管理
- 📁 文件管理
- 🔗 MCP(Model Context Protocol)支持
使用场景
- 与 Claude Desktop 交互
- 通过 Claude 管理笔记
- AI 驱动的文件操作
编辑增强类
Advanced Tables
版本:0.22.1 | 官网:https://grosinger.net
插件描述
增强 Markdown 表格功能,提供更好的表格导航、格式化、操作和公式支持。
主要功能
- ✨ 自动表格格式化和对齐
- ⌨️ Tab 键在表格单元格间导航
- ➕ 快速添加/删除行和列
- 🧮 表格内公式计算
- 🔄 自动完成表格语法
使用技巧
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |
- 按
Tab键在表格单元格间跳转 - 按
Enter在表格末尾自动添加新行 - 使用公式功能(如 SUM、AVERAGE)进行计算
官方文档
https://github.com/tgrosinger/advanced-tables-obsidian
Easy Typing
版本:5.5.15 | 作者:yaozhuwa
插件描述
优化 Obsidian 的编辑体验,提供更好的中文输入支持。
主要功能
- 🔤 中英文自动空格
- 📝 中文标点优化
- 🔢 智能括号配对
- ⌫ 增强的退格键功能
- ✨ 自动格式化
- 💻 代码块编辑增强
- ⇥ Tab 跳出括号
关键设置项
- Tabout:已启用(Tab 键跳出括号)
- 选择增强:已启用
- 成对符号:已启用
- 编辑增强:已启用
- 全角半角转换:已启用
- 代码编辑增强:已启用
- 智能退格:已启用
- 自动格式化:已启用
- 中英文间加空格:已启用
- 中文数字间加空格:已启用
- 自动大写:已启用
使用场景
- 中文笔记写作
- 混合中英文编辑
- 提升编辑效率
特别功能
- 修复中文输入法问题
- 优化标点符号输入
- 自动修正格式错误
Code Styler
版本:1.1.7 | 作者:Mayuran Visakan
插件描述
在编辑模式和阅读模式下美化和自定义代码块和行内代码。
主要功能
- 🎨 代码块主题定制
- 🌈 代码高亮优化
- 💎 行内代码样式
- 📌 代码块标题
- 🔢 行号显示
- 📁 代码折叠
使用场景
- 美化代码展示
- 提升代码可读性
- 自定义代码外观
Advanced Codeblock
版本:1.1.5 | 作者:Lijyze
插件描述
为代码块添加额外功能。
主要功能
- 📋 代码复制按钮
- 📁 代码折叠
- 🏷️ 代码块标题
- 🌈 代码高亮增强
- 🔢 行号显示
CM CHS Patch
完整名称:Word Splitting for Simplified Chinese in Edit Mode and Vim Mode 版本:1.12.0 | 作者:AidenLx
插件描述
为 Obsidian 内置的 CodeMirror 编辑器添加简体中文分词支持。
主要功能
- 🔤 中文分词
- 🎯 Vim 模式中文支持
- ✏️ 编辑模式优化
- 🖱️ 光标移动优化
关键设置项
- 使用结巴分词:已启用
- HMM:已启用
- 按中文词移动:已启用
- 移动至中文标点:已启用
使用场景
- 中文笔记编辑
- Vim 模式下的中文操作
- 提升中文光标移动体验
特别说明
- 专为中文用户优化
- 改善 Vim 模式下的中文编辑
- 使光标按词而非字移动
任务管理类
Tasks
版本:7.22.0 | 官方文档:https://publish.obsidian.md/tasks/
插件描述
在整个 vault 中跟踪任务,支持截止日期、重复任务、完成日期和过滤。
主要功能
- ✅ 任务管理和跟踪
- 📅 截止日期(due date)
- 📆 计划日期(scheduled date)
- 🏁 开始日期(start date)
- 🔄 重复任务(recurrence)
- ⭐ 任务优先级
- 📊 任务状态(待办、进行中、已完成、已取消)
- 🔍 强大的任务查询语法
关键设置项
- 任务格式:使用 emoji 标记
- 自动设置完成日期:已启用
- 自动设置取消日期:已启用
- 自动建议:已启用
自定义任务状态
- [ ] 待办(Todo)
- [x] 已完成(Done)
- [/] 进行中(In Progress)
- [-] 已取消(Cancelled)
任务查询示例
```tasks
not done
due today
path includes {{query.file.path}}
```
使用技巧
- 在任何笔记中使用
- [ ]创建任务 - 使用代码块
tasks创建任务查询 - 设置任务元数据(如
📅 2026-01-10)
Kanban
版本:2.0.51 | 官方文档:https://publish.obsidian.md/kanban/
插件描述
创建基于 Markdown 的看板(Kanban),进行项目管理。
主要功能
- 📋 创建看板视图
- 🖱️ 拖拽卡片
- 📊 列管理
- ✅ 任务跟踪
- 📝 Markdown 格式存储
关键设置项
- 显示复选框:已启用
- 隐藏卡片计数:已启用
使用方法
- 命令面板 →
Kanban: Create new board - 创建列(如:待办、进行中、已完成)
- 添加卡片并拖拽管理
适用场景
- 项目任务管理
- 工作流程可视化
- 敏捷开发看板
Calendar
版本:1.5.10 | 作者:Liam Cain
插件描述
在侧边栏显示日历视图,快速访问每日笔记。
主要功能
- 📅 月历视图
- 📝 快速创建和访问每日笔记
- 🏷️ 显示已有笔记的日期标记
- 🔗 与每日笔记集成
使用方法
- 点击日期创建或打开对应日期的笔记
- 点击当前日期快速打开今日笔记
- 在侧边栏固定日历视图
模板和自动化类
Templater
版本:2.16.4 | 官方文档:https://silentvoid13.github.io/Templater/
💡 详细文档:本插件有完整的中文使用指南,请参阅:
- Templater-User-Guide - 用户指南
- Templater-Setup-Guide - 设置指南
- Templater-Quick-Reference - 快速参考
插件描述
Obsidian 最强大的模板插件,创建和使用动态模板。
主要功能
- 📅 动态日期和时间变量
- 📄 文件信息获取
- ❓ 用户输入提示
- 💻 JavaScript 代码执行
- 📁 文件操作(创建、移动、重命名)
- 🗂️ 文件夹模板自动应用
关键设置项
- 模板文件夹:
06_Metadata/Templates - 创建新文件时触发:已启用
- 启用文件夹模板:已启用
文件夹模板映射
00_Inbox→Daily Note Template.md01_Projects→Project Template.md03_Resources/Books→book-note.md
常用语法
今天:2026-01-05
文件名:Obsidian-Plugins-Manual
用户输入:null
使用方法
- 命令面板 →
Templater: Insert Template - 设置快捷键(推荐
Ctrl+T) - 在指定文件夹创建文件自动应用模板
搜索和导航类
Omnisearch
版本:1.27.3 | 作者:Simon Cambier
插件描述
一个"开箱即用"的搜索引擎,增强 Obsidian 的搜索功能。
主要功能
- 🔍 全局快速搜索
- 🧠 智能搜索算法
- 📊 搜索结果排序
- 👀 搜索预览
- 🇨🇳 支持中文分词
使用方法
- 使用快捷键打开搜索(通常
Ctrl+O) - 输入关键词即时搜索
- 支持模糊搜索
优势
- 比 Obsidian 原生搜索更快
- 更智能的结果排序
- 更好的中文支持
Dataview
版本:0.5.68 | 官方文档:https://blacksmithgu.github.io/obsidian-dataview/
插件描述
为数据控们提供的复杂数据视图插件。
主要功能
- 🔍 笔记查询和过滤
- 📊 数据表格生成
- 📝 列表和任务聚合
- 📅 日历视图
- 💻 JavaScript 查询(DataviewJS)
- 🔢 行内查询
关键设置项
- 默认日期格式:
MMMM dd, yyyy - 默认日期时间格式:
h:mm a - MMMM dd, yyyy - 显示结果计数:已启用
- 允许 HTML:已启用
- 启用 Dataview:已启用
- 启用 DataviewJS:已启用
- 启用行内查询:已启用
- 行内查询前缀:
= - JS 行内查询前缀:
$=
查询示例
基础查询:
```dataview
TABLE file.ctime as "创建时间", file.mtime as "修改时间"
FROM "01_Projects"
WHERE status = "active"
SORT file.mtime DESC
```
列表查询:
```dataview
LIST
FROM #reading
WHERE status = "reading"
```
任务查询:
```dataview
TASK
FROM "01_Projects"
WHERE !completed
```
行内查询:
这个笔记创建于 `= this.file.ctime`
使用场景
- 项目追踪
- 任务管理
- 阅读列表
- 知识库统计
- 动态目录
学习资源
可视化类
Excalidraw
版本:2.18.3 | 作者:Zsolt Viczian | 官网:https://excalidraw-obsidian.online
插件描述
在 Obsidian 中编辑和查看 Excalidraw 绘图,进入 4D 可视化 PKM 世界。
主要功能
- ✏️ 手绘风格绘图
- 🧠 思维导图
- 📊 流程图和图表
- 🖼️ 图片标注
- 📄 PDF 标注
- 📝 嵌入笔记内容
- 💾 导出为 PNG/SVG
关键设置项
- 文件夹:
Excalidraw - 模板文件:
Excalidraw/Template.excalidraw - 脚本文件夹:
Excalidraw/Scripts - 压缩:已启用
- 自动保存:已启用(桌面 60秒,移动 30秒)
- 文件名前缀:
Drawing - 预览图片类型:SVG
- 桌面 UI 模式:tray
- 平板 UI 模式:compact
- 打开时缩放至适合:已启用
使用方法
- 命令面板 →
Excalidraw: Create new drawing - 拖拽工具创建图形
- 使用笔工具手绘
- 插入文本和链接
使用场景
- 头脑风暴
- 视觉化笔记
- 图解说明
- 演示图表
快捷键
R- 矩形工具D- 菱形工具C- 圆形工具A- 箭头工具L- 线条工具P- 笔工具T- 文本工具
Mind Map
版本:1.1.0
插件描述
将笔记预览为 Markmap 思维导图。
主要功能
- 🗺️ Markdown 转思维导图
- 🌳 基于标题层级生成
- 👀 可视化笔记结构
- 🖱️ 交互式导航
使用方法
- 命令面板 →
Mind Map: Preview - 自动根据标题层级生成思维导图
- 点击节点展开/折叠
使用场景
- 笔记大纲可视化
- 知识结构梳理
- 演讲大纲展示
Advanced Canvas
版本:5.6.5 | 作者:Developer-Mike
插件描述
增强 Canvas(画布)功能,创建演示文稿、流程图等。
主要功能
- 🎥 画布演示模式
- 📊 流程图增强
- 🧭 画布导航
- 🎨 节点样式优化
- 📽️ 幻灯片模式
使用场景
- 创建思维导图
- 制作演示文稿
- 可视化知识结构
- 项目规划
版本控制和备份类
Git
版本:2.36.0 | 作者:Vinzent
插件描述
集成 Git 版本控制,支持自动备份和高级功能。
主要功能
- 🔄 自动提交和推送
- ⏰ 定时备份笔记
- 🌿 支持分支管理
- 📜 查看文件历史和差异
- ⚠️ 冲突解决
关键设置项
- 提交信息格式:
vault backup: {{date}} - 日期格式:
YYYY-MM-DD HH:mm:ss - 启动时自动拉取:已启用
- 推送前先拉取:已启用
- 同步方法:merge
- 显示状态栏:已启用
- 显示分支状态:已启用
常用命令
Git: Commit all changes # 手动提交
Git: Push # 推送到远程
Git: Pull # 拉取更新
Git: Open file history # 查看历史
Git: Open diff view # 查看差异
使用方法
- 命令面板:搜索 "Git" 查看所有命令
- 手动提交:
Git: Commit all changes - 推送到远程:
Git: Push - 拉取更新:
Git: Pull - 查看历史:
Git: Open file history
自动备份
- 插件会根据设置自动定时提交和推送
- 状态栏显示 Git 状态和分支信息
- 支持手动触发备份
外观定制类
Style Settings
版本:1.0.9
插件描述
调整主题、插件和代码片段的 CSS 变量。
主要功能
- 🎨 自定义主题颜色
- 🔤 调整字体大小和样式
- 🖼️ 修改插件外观
- 🎛️ CSS 变量可视化控制
使用场景
- 个性化 Obsidian 外观
- 微调主题细节
- 不需要编写 CSS 代码
Iconize
原名:Icon Folder 版本:2.14.7 | 作者:Florian Woelki
插件描述
为文件、文件夹和文本添加图标。
主要功能
- 📁 文件夹图标
- 📄 文件图标
- ✨ 行内图标(在文本中使用)
- 🎨 支持多种图标库(Emoji、Lucide、自定义)
关键设置项
- 图标包路径:
.obsidian/icons - 图标大小:16px
- Emoji 风格:native
- 在标签页显示图标:已启用
- 在标题显示图标:已启用
- 在 frontmatter 启用图标:已启用
- 图标标识符:
:
使用方法
为文件夹添加图标:
- 右键点击文件/文件夹
- 选择 "Change icon"
- 选择喜欢的图标
在 frontmatter 中使用:
---
icon: :emoji:
---
在文本中使用:
这是一个图标 :icon_name: 示例
Better Word Count
版本:0.10.1 | 作者:Luke Leppan
插件描述
统计编辑器中选中文本的字数。
主要功能
- 📊 实时字数统计
- ✂️ 选中文本统计
- 🔤 字符数统计
- 🇨🇳 中文字符支持
- 📍 状态栏显示
使用场景
- 写作字数追踪
- 文章长度控制
- 翻译字数统计
集成和扩展类
Local REST API
版本:3.2.0 | 类型:桌面端专用
插件描述
通过 REST API 与 Obsidian 笔记进行交互,支持获取、修改笔记。
主要功能
- 🌐 提供本地 REST API 接口
- 🔗 允许外部程序读取和修改笔记
- 🤖 支持自动化工作流集成
使用场景
- 与其他应用集成(如 Python 脚本、自动化工具)
- 远程管理笔记
- 批量处理笔记内容
API 端点示例
# 获取所有笔记
GET http://localhost:27123/vault/
# 读取特定笔记
GET http://localhost:27123/vault/note.md
# 创建笔记
POST http://localhost:27123/vault/note.md
Advanced URI
版本:1.46.0 | 作者:Vinzent
插件描述
扩展 Obsidian URI,提供高级模式。
主要功能
- 🔗 创建高级链接
- 🎯 直接跳转到笔记特定位置
- ⚡ 执行命令
- 🔍 搜索和替换
- ➕ 追加内容到笔记
使用场景
- 外部应用集成
- 自动化工作流
- 快速启动器
- 笔记间深度链接
URI 示例
打开特定笔记并跳转到特定行:
obsidian://advanced-uri?vault=my-vault&filepath=note.md&line=10
执行命令:
obsidian://advanced-uri?vault=my-vault&commandid=command-id
搜索并替换:
obsidian://advanced-uri?vault=my-vault&filepath=note.md&search=old&replace=new
追加内容:
obsidian://advanced-uri?vault=my-vault&filepath=note.md&data=content&mode=append
使用建议
新手推荐优先使用
| 插件 | 理由 | 学习曲线 |
|---|---|---|
| Templater | 提升笔记创建效率 | ⭐⭐ |
| Calendar | 可视化日历 | ⭐ |
| Git | 自动备份笔记 | ⭐ |
| Easy Typing | 中文输入优化 | ⭐ |
| Iconize | 美化文件夹 | ⭐ |
| Better Word Count | 字数统计 | ⭐ |
进阶用户推荐
| 插件 | 理由 | 学习曲线 |
|---|---|---|
| Dataview | 动态数据查询 | ⭐⭐⭐⭐ |
| Tasks | 任务管理系统 | ⭐⭐⭐ |
| Excalidraw | 可视化绘图 | ⭐⭐ |
| Copilot | AI 辅助写作 | ⭐⭐⭐ |
| Kanban | 项目管理 | ⭐⭐ |
开发者和高级用户
| 插件 | 理由 | 学习曲线 |
|---|---|---|
| Local REST API | 外部集成 | ⭐⭐⭐⭐ |
| Advanced URI | 自动化工作流 | ⭐⭐⭐ |
| DataviewJS | 自定义查询 | ⭐⭐⭐⭐⭐ |
插件组合推荐
📝 写作流程:
- Templater + Easy Typing + Better Word Count + Copilot
🎯 任务管理:
- Tasks + Kanban + Calendar + Dataview
🎨 可视化知识管理:
- Excalidraw + Mind Map + Advanced Canvas
🔍 知识检索:
- Omnisearch + Dataview + Smart Connections
💾 备份和版本控制:
- Git + Local REST API
注意事项
插件冲突
⚠️ 可能冲突的插件组合:
- Easy Typing + CM CHS Patch:两者都修改编辑器行为,可能有冲突
- Code Styler + Advanced Codeblock:功能重叠,可根据需要选择其一
性能影响
🚀 对性能影响较大的插件:
- Dataview:大量查询会影响性能,建议优化查询
- Smart Connections:向量索引需要计算资源
- Copilot:AI 模型调用需要网络和计算资源
- Git:频繁自动提交可能影响编辑流畅度
💡 优化建议:
- 合理设置 Git 自动提交间隔
- 限制 Dataview 查询范围
- 按需启用 Smart Connections 索引
数据安全
🔒 备份策略:
- 必须启用:Git 插件自动备份
- 推荐:定期手动备份到其他位置
- 云同步:使用 Git 推送到远程仓库
⚠️ 隐私注意:
- Copilot、Smart Connections 等 AI 插件会将笔记内容发送到 AI 服务
- 敏感内容建议排除在 AI 索引之外
学习资源
📚 推荐学习顺序:
- 基础:先掌握 Templater、Calendar、Git
- 进阶:学习 Tasks、Dataview
- 高级:探索 DataviewJS、API 集成
🔗 官方文档链接:
附录
所有插件完整列表
- Claudian (1.3.16)
- Local REST API (3.2.0)
- Advanced Tables (0.22.1)
- Smart Connections (4.1.7)
- Git (2.36.0)
- Templater (2.16.4)
- Tasks (7.22.0)
- Calendar (1.5.10)
- Kanban (2.0.51)
- Style Settings (1.0.9)
- Iconize (2.14.7)
- Omnisearch (1.27.3)
- Copilot (3.1.4)
- Easy Typing (5.5.15)
- Code Styler (1.1.7)
- Advanced URI (1.46.0)
- Advanced Canvas (5.6.5)
- Advanced Codeblock (1.1.5)
- Better Word Count (0.10.1)
- Dataview (0.5.68)
- Excalidraw (2.18.3)
- MCP Tools (0.2.27)
- Mind Map (1.1.0)
- CM CHS Patch (1.12.0)
版本信息
文档版本:1.0 创建日期:2026年1月5日 最后更新:2026年1月5日 维护者:Claudian AI Assistant
相关文档
- Templater-User-Guide - Templater 详细用户指南
- Templater-Setup-Guide - Templater 设置指南
- Templater-Quick-Reference - Templater 快速参考
- README - Vault 主说明文档
💡 提示:本文档会随着插件更新而更新。建议定期查看插件的官方文档以获取最新信息。