Obsidian 学习笔记

插件系统 ​

版本说明

本文档基于 Obsidian v1.13 (稳定版) 编写。插件系统会持续更新，建议关注官方更新日志了解最新变化。

概述 ​

Obsidian 拥有丰富的插件生态系统，分为两类：

  • 核心插件：Obsidian 官方提供，开箱即用
  • 社区插件：由社区开发者贡献，需要手动安装

截至目前，社区插件数量已超过 4500+，涵盖效率提升、知识管理、外观美化等各个领域。

核心插件 ​

常用核心插件 ​

插件名称功能描述
白板创建无限画布进行可视化笔记
日记快速创建每日笔记
模板插入预定义的模板内容
大纲显示当前文档的标题结构
字数统计统计选中或全文的字数
幻灯片将笔记转换为幻灯片演示
关系图谱可视化笔记之间的关联
星标收藏重要文件
随机漫游随机打开笔记进行回顾
工作区保存和恢复窗口布局
出链显示当前笔记的出链和入链
标签面板显示所有标签列表

启用核心插件 ​

  1. 打开设置 → 核心插件
  2. 找到需要的插件
  3. 打开开关启用

核心插件详解 ​

白板（Canvas） ​

白板是 Obsidian 1.1 版本引入的强大功能：

  • 无限画布：在无限大的空间中组织笔记
  • 多种元素：支持卡片、图片、视频、网页、PDF
  • 连接关系：用箭头连接不同元素展示关系
  • 嵌套白板：白板可以嵌入其他白板

工作区（Workspaces） ​

保存常用的窗口布局：

  1. 配置好窗口布局
  2. 打开命令面板（Ctrl/Cmd + P）
  3. 搜索「工作区：保存工作区」
  4. 命名并保存

切换工作区可快速恢复不同的使用场景布局。

社区插件 ​

安装社区插件 ​

首次启用 ​

  1. 打开设置 → 第三方插件
  2. 点击「关闭安全模式」
  3. 点击「浏览」搜索插件

安装步骤 ​

  1. 在插件市场搜索插件名称
  2. 点击「安装」
  3. 安装完成后点击「启用」

从 BRAT 安装 ​

对于发布在 GitHub 但未上架市场的插件，可使用 BRAT 插件安装：

  1. 先安装 BRAT 插件
  2. 打开 BRAT 设置
  3. 添加插件的 GitHub 仓库地址
  4. 选择版本进行安装

推荐社区插件 ​

效率提升 ​

插件名称功能描述
Templater高级模板系统，支持动态内容
Dataview数据查询和展示
Tasks任务管理和追踪
QuickAdd快速添加笔记和内容
Calendar日历视图增强
Commander自定义命令按钮
Recent Files最近打开的文件列表
Omnisearch智能全文搜索

编辑增强 ​

插件名称功能描述
Editing Toolbar编辑工具栏
Advanced Tables表格编辑增强
Paste URL into selection快速插入链接
Copy Block Link复制块链接
Editor Syntax Highlight代码块语法高亮
Code Styler代码块样式定制
Linter格式化 Markdown

外观美化 ​

插件名称功能描述
Minimal Theme SettingsMinimal 主题配套设置
Style Settings样式自定义设置
Banners笔记横幅图片
Iconize文件夹和文件图标
File Explorer++文件浏览器增强

知识管理 ​

插件名称功能描述
Excalidraw手绘风格绘图
Mind Map思维导图
Kanban看板视图
Spaced Repetition间隔重复记忆
Obsidian Booknote书籍管理
Zotero Integration文献管理集成

插件管理 ​

手动安装 ​

如果无法访问插件市场，可以手动安装：

  1. 从 GitHub 下载插件 main.js、manifest.json、styles.css（可选）
  2. 在仓库目录创建文件夹：.obsidian/plugins/插件名/
  3. 将下载的文件放入该文件夹
  4. 重启 Obsidian 并启用插件

插件更新 ​

自动更新 ​

Obsidian 默认会自动检查插件更新：

  1. 设置 → 第三方插件
  2. 开启「自动检查更新」
  3. 有更新时会显示提示

手动更新 ​

  1. 设置 → 第三方插件
  2. 点击「检查更新」
  3. 点击「更新全部」或单独更新

更新注意事项 ​

更新提醒

  • 大版本更新可能包含破坏性变更，建议先查看更新日志
  • 重要仓库建议在更新前备份
  • 如果更新后出现问题，可回退到旧版本

备份插件列表 ​

插件配置存储位置：

文件说明
community-plugins.json已启用的社区插件列表
community-plugins.json (disabled)已安装但禁用的插件
plugins/插件名/data.json单个插件的配置数据

插件文件结构 ​

text
.obsidian/
├── community-plugins.json    # 启用的插件列表
├── plugins/
│   ├── dataview/
│   │   ├── main.js          # 插件主代码
│   │   ├── manifest.json    # 插件元信息
│   │   ├── styles.css       # 插件样式（可选）
│   │   └── data.json        # 用户配置
│   └── templater-obsidian/
│       └── ...

插件冲突排查 ​

常见冲突症状 ​

  • Obsidian 启动变慢
  • 某些功能不响应
  • 控制台出现错误信息
  • 界面显示异常

排查步骤 ​

方法一：二分排查法 ​

  1. 禁用所有社区插件
  2. 检查问题是否解决
  3. 如果解决，逐个启用插件
  4. 每次启用后测试，定位问题插件

方法二：安全模式 ​

  1. 完全关闭 Obsidian
  2. 打开时按住 Ctrl + Shift（Windows/Linux） 或 Cmd + Shift（macOS）
  3. Obsidian 将以安全模式启动（不加载社区插件）
  4. 确认问题是否与插件相关

方法三：查看控制台 ​

  1. 按 Ctrl/Cmd + Shift + I 打开开发者工具
  2. 切换到 Console 标签
  3. 查看红色错误信息
  4. 错误通常会指出是哪个插件

常见冲突场景 ​

冲突类型涉及插件解决方案
编辑器冲突多个编辑增强插件只保留一个主力编辑插件
主题冲突主题与 CSS 片段检查 CSS 选择器是否重叠
快捷键冲突多个插件绑定相同快捷键在快捷键设置中重新分配
渲染冲突Dataview 与其他查询插件检查 Codeblock 语法

性能优化 ​

影响性能的因素 ​

因素影响程度说明
插件数量⭐⭐⭐每个插件都需要加载和运行
仓库大小⭐⭐大量文件影响索引速度
复杂查询⭐⭐⭐Dataview 等复杂查询消耗资源
实时预览⭐大文档时较明显

优化建议 ​

减少启动时间 ​

javascript
// 在插件设置中，对不常用插件启用延迟加载
// 或使用「延迟加载」类型的启动选项

建议操作：

  1. 禁用不常用的插件
  2. 使用「启动时延迟加载」选项（如果插件支持）
  3. 检查是否有重复功能的插件

减少运行时开销 ​

  • Dataview：避免过多实时查询，使用 dataviewjs 时注意性能
  • Templater：减少启动模板，改用手动触发
  • Tasks：减少查询范围，使用 limit 限制结果

定期维护 ​

bash
# 查找大于 1MB 的文件
find . -type f -size +1M -exec ls -lh {} \;
bash
# 清理 Obsidian 缓存（关闭 Obsidian 后执行）
rm -rf .obsidian/workspace
rm -rf .obsidian/workspace-mobile

性能监控 ​

使用命令面板搜索「显示调试信息」查看：

  • 启动时间
  • 插件加载时间
  • 内存使用情况

插件开发 ​

如果你想开发自己的插件，请参考 开发指南。

开发资源 ​

常见问题 ​

插件安装失败？ ​

  1. 检查网络连接
  2. 尝试使用 VPN 或代理
  3. 使用手动安装方式
  4. 检查 GitHub 仓库是否可访问

插件不显示？ ​

  1. 确认已关闭安全模式
  2. 检查插件是否已启用
  3. 重启 Obsidian
  4. 检查 .obsidian/plugins/ 目录权限

如何卸载插件？ ​

  1. 设置 → 第三方插件
  2. 点击插件旁的设置图标
  3. 选择「卸载」

注意

卸载插件会删除该插件的所有配置数据，如需保留配置请先备份。

热门插件详解 ​

Dataview ​

Dataview 是 Obsidian 最强大的数据查询插件之一，可以将笔记变成可查询的数据库。

核心功能 ​

  • 数据查询：使用类 SQL 语法查询笔记元数据
  • 动态视图：自动更新查询结果
  • 多种输出格式：表格、列表、任务列表

常用查询示例 ​

dataview
TABLE file.ctime AS "创建时间", tags AS "标签"
FROM "日记"
WHERE file.ctime >= date(today) - dur(7 days)
SORT file.ctime DESC

使用场景 ​

  • 自动汇总最近创建的笔记
  • 统计特定标签的内容
  • 构建项目进度追踪表
  • 生成读书清单

Templater ​

Templater 是一个强大的模板插件，支持动态内容和自动化操作。

核心功能 ​

  • 动态模板：插入日期、时间、文件夹名等动态内容
  • 用户输入：创建笔记时提示输入
  • 脚本执行：运行 JavaScript 代码
  • 自动化：新建笔记自动应用模板

常用模板语法 ​

markdown
<% tp.date.now("YYYY-MM-DD") %>           // 当前日期
<% tp.file.title %>                        // 文件标题
<% tp.file.folder() %>                     // 所在文件夹
<% tp.system.clipboard() %>                // 剪贴板内容
<% tp.user.MyFunction() %>                 // 用户脚本

配置建议 ​

  1. 设置模板文件夹路径
  2. 配置新建笔记自动应用模板
  3. 创建不同用途的模板文件

Calendar ​

Calendar 插件为 Obsidian 添加日历视图，方便管理每日笔记。

核心功能 ​

  • 日历视图：月历形式展示笔记
  • 快速创建：点击日期创建每日笔记
  • 视觉标记：有笔记的日期显示圆点
  • 周数显示：可选显示周数

使用场景 ​

  • 管理日记和每日笔记
  • 追踪写作频率
  • 规划每周任务
  • 回顾历史记录

推荐配置 ​

  • 配合「日记」核心插件使用
  • 设置每日笔记存放文件夹
  • 自定义每日笔记模板

Excalidraw ​

Excalidraw 是手绘风格的绘图工具，可以嵌入笔记中使用。

核心功能 ​

  • 手绘风格：自然的手绘线条效果
  • 多种工具：矩形、箭头、文本、自由绘制
  • 嵌入笔记：绘图直接嵌入 Markdown
  • 库支持：使用社区绘图元素库
  • 双向链接：元素可以链接到其他笔记

使用场景 ​

  • 绘制概念图和流程图
  • 创建手绘风格示意图
  • 制作思维导图
  • 添加手写标注
  • 构建交互式图表

使用技巧 ​

  1. 使用 Ctrl/Cmd + 点击 创建链接
  2. 导出为 PNG/SVG 用于分享
  3. 创建可复用的图形库
  4. 配合 Obsidian Publish 发布

下一步 ​

相关文章

进阶功能钥匙串集中管理 API 密钥和密码凭证，让社区插件安全地访问第三方服务接口。进阶功能移动端与桌面协同实现移动端和桌面端的无缝协同工作，提升知识管理效率进阶功能移动端同步完整方案详细介绍 Obsidian 在 iOS 和 Android 平台的各种同步方案，帮助你选择最适合自己的方案。进阶功能移动端小组件学习如何在 iOS 和 Android 设备上使用 Obsidian 小组件，提升移动端使用效率。