Files
my-vault/06_Metadata/Obsidian-Plugins-Manual.md
T

24 KiB
Raw Blame History

title, created, updated, tags, type
title created updated tags type
Obsidian 插件使用手册 2026-01-05 2026-01-05
obsidian
plugins
manual
reference
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 - 日历视图

模板和自动化类

搜索和导航类

  • 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 助手代理功能

使用方法

  1. 点击侧边栏的 Claudian 图标打开 AI 聊天窗口
  2. 直接与 Claude 对话,询问笔记相关问题
  3. 可以让 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
  • 最大 tokens6000
  • 上下文轮数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 集成
  • 🔍 语义搜索
  • 📋 模板管理
  • 📁 文件管理
  • 🔗 MCPModel 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 格式存储

关键设置项

  • 显示复选框:已启用
  • 隐藏卡片计数:已启用

使用方法

  1. 命令面板 → Kanban: Create new board
  2. 创建列(如:待办、进行中、已完成)
  3. 添加卡片并拖拽管理

适用场景

  • 项目任务管理
  • 工作流程可视化
  • 敏捷开发看板

Calendar

版本1.5.10 | 作者Liam Cain

插件描述

在侧边栏显示日历视图,快速访问每日笔记。

主要功能

  • 📅 月历视图
  • 📝 快速创建和访问每日笔记
  • 🏷️ 显示已有笔记的日期标记
  • 🔗 与每日笔记集成

使用方法

  • 点击日期创建或打开对应日期的笔记
  • 点击当前日期快速打开今日笔记
  • 在侧边栏固定日历视图

模板和自动化类

Templater

版本2.16.4 | 官方文档https://silentvoid13.github.io/Templater/

💡 详细文档:本插件有完整的中文使用指南,请参阅:

插件描述

Obsidian 最强大的模板插件,创建和使用动态模板。

主要功能

  • 📅 动态日期和时间变量
  • 📄 文件信息获取
  • 用户输入提示
  • 💻 JavaScript 代码执行
  • 📁 文件操作(创建、移动、重命名)
  • 🗂️ 文件夹模板自动应用

关键设置项

  • 模板文件夹06_Metadata/Templates
  • 创建新文件时触发:已启用
  • 启用文件夹模板:已启用

文件夹模板映射

  • 00_InboxDaily Note Template.md
  • 01_ProjectsProject Template.md
  • 03_Resources/Booksbook-note.md

常用语法

今天2026-01-05
文件名Obsidian-Plugins-Manual
用户输入null

使用方法

  1. 命令面板 → Templater: Insert Template
  2. 设置快捷键(推荐 Ctrl+T
  3. 在指定文件夹创建文件自动应用模板

搜索和导航类

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
  • 打开时缩放至适合:已启用

使用方法

  1. 命令面板 → Excalidraw: Create new drawing
  2. 拖拽工具创建图形
  3. 使用笔工具手绘
  4. 插入文本和链接

使用场景

  • 头脑风暴
  • 视觉化笔记
  • 图解说明
  • 演示图表

快捷键

  • 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         # 查看差异

使用方法

  1. 命令面板:搜索 "Git" 查看所有命令
  2. 手动提交:Git: Commit all changes
  3. 推送到远程:Git: Push
  4. 拉取更新:Git: Pull
  5. 查看历史: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 启用图标:已启用
  • 图标标识符:

使用方法

为文件夹添加图标

  1. 右键点击文件/文件夹
  2. 选择 "Change icon"
  3. 选择喜欢的图标

在 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:向量索引需要计算资源
  • CopilotAI 模型调用需要网络和计算资源
  • Git:频繁自动提交可能影响编辑流畅度

💡 优化建议

  • 合理设置 Git 自动提交间隔
  • 限制 Dataview 查询范围
  • 按需启用 Smart Connections 索引

数据安全

🔒 备份策略

  1. 必须启用Git 插件自动备份
  2. 推荐:定期手动备份到其他位置
  3. 云同步:使用 Git 推送到远程仓库

⚠️ 隐私注意

  • Copilot、Smart Connections 等 AI 插件会将笔记内容发送到 AI 服务
  • 敏感内容建议排除在 AI 索引之外

学习资源

📚 推荐学习顺序

  1. 基础:先掌握 Templater、Calendar、Git
  2. 进阶:学习 Tasks、Dataview
  3. 高级:探索 DataviewJS、API 集成

🔗 官方文档链接


附录

所有插件完整列表

  1. Claudian (1.3.16)
  2. Local REST API (3.2.0)
  3. Advanced Tables (0.22.1)
  4. Smart Connections (4.1.7)
  5. Git (2.36.0)
  6. Templater (2.16.4)
  7. Tasks (7.22.0)
  8. Calendar (1.5.10)
  9. Kanban (2.0.51)
  10. Style Settings (1.0.9)
  11. Iconize (2.14.7)
  12. Omnisearch (1.27.3)
  13. Copilot (3.1.4)
  14. Easy Typing (5.5.15)
  15. Code Styler (1.1.7)
  16. Advanced URI (1.46.0)
  17. Advanced Canvas (5.6.5)
  18. Advanced Codeblock (1.1.5)
  19. Better Word Count (0.10.1)
  20. Dataview (0.5.68)
  21. Excalidraw (2.18.3)
  22. MCP Tools (0.2.27)
  23. Mind Map (1.1.0)
  24. CM CHS Patch (1.12.0)

版本信息

文档版本1.0 创建日期2026年1月5日 最后更新2026年1月5日 维护者Claudian AI Assistant


相关文档


💡 提示:本文档会随着插件更新而更新。建议定期查看插件的官方文档以获取最新信息。