Obsidian 插件：QuickAdd

适配人群：Obsidian 纯新手 / 插件入门者

核心依据：QuickAdd 官方文档+ 真实日常场景落地

核心承诺：无遗漏步骤、无晦涩术语、跟着做就能用、覆盖 100% 高频场景

前言：QuickAdd 到底是什么？（官方定位）#

QuickAdd 是 Obsidian 「重复工作一键自动化」神器，官方定义：为可复用的工作流提供一个快速命令。

简单说：把你每天要做的「新建笔记、记日记、加任务、连串操作」，从5 步变成 1 步。

它能解决你的 3 大痛点#

1. 记灵感时：不用退出当前笔记，一键捕获到日记 / 清单
2. 建笔记时：不用手动套模板、改名字、选文件夹，全自动完成
3. 复杂操作时：不用一步步点，一个快捷键完成「连招」

官方 5 大功能（新手先学前 4 个）#

1. Capture：捕获 → 往已有笔记里加内容（记灵感、日记、日志）
2. Template：模板 → 用模板新建规范笔记（读书笔记、会议记录）
3. Macro：宏命令 → 一键执行多步连招（自动化天花板）
4. Multi：分类 → 给指令做「收纳盒」（整理杂乱的指令）
5. Package：打包 → 跨库分享你的工作流（高阶）

安装与启用（略）

核心通用上手规则，不管用 Capture/Template/Macro 哪个功能，官方固定全流程只有 5 步：

1. 新建指令 → 2. 命名（命令面板能搜到）→ 3. 配置参数 → 4. 测试运行 → 5. 设快捷键

官方关键提醒：命名一定要直白！比如「捕获日记灵感」「新建读书笔记」，别用英文缩写。

功能 1：Capture 捕获 —— 「不打断工作，快速记灵感」#

官方定义：向日记、日志、任务清单、现有文件追加文本

你的场景：写读书笔记时突然想记琐事，不想退出当前页面

Step1：新建 Capture 指令#

1. 打开 QuickAdd 设置 → 选择 Capture → 输入名称：捕获-日记灵感
2. 点击 Add choice → 点亮右侧小闪电（加入命令面板）
3. 点击指令旁小齿轮（进入设置）

Step2：核心配置（逐行填，不遗漏）#

Step3：测试运行#

1. 命令面板（Ctrl/Cmd+P）→ 搜索 QuickAdd: Run QuickAdd
2. 选择 捕获-日记灵感 → 输入内容 → 确定
3. 效果：不退出当前笔记，内容自动进当日日记指定位置

Step4：设置快捷键（官方推荐）#

Obsidian 设置 → 「快捷键」→ 搜索 捕获-日记灵感 → 自定义：Ctrl/Cmd+Shift+1

功能 2：Template 模板 —— 「一键新建规范笔记」#

官方定义：从可复用模板创建新笔记

你的场景：读书笔记、会议记录、日记，必须统一格式、统一文件夹、统一命名

Step1：新建 Template 指令#

1. QuickAdd 设置 → 选择 Template → 名称：模板-新建读书笔记
2. 点击 Add choice → 点亮小闪电
3. 点击小齿轮进入设置

Step2：核心配置（逐行填）#

Step3：测试运行#

命令面板搜索指令 → 输入书名 → 自动生成：

✅ 套模板 ✅ 规范命名 ✅ 存入指定文件夹 ✅ 自动打开

Step4：快捷键#

自定义：Ctrl/Cmd+Shift+2

功能 3：Macro 宏命令 —— 「一键连招，多步操作合并」#

官方定义：运行一个 / 多个 Obsidian 命令、脚本、Choice

你的场景：会议笔记添加新参会人 → 自动创建人物笔记 + 双向链接

Step1：新建 Macro 基础设置#

1. QuickAdd 设置 → 点击 Manage Macros → 名称：宏-添加参会人 → 「Add」
2. 点击 Configure 配置步骤

Step2：添加第一步：Capture（添加链接到会议笔记）#

1. 点击 Capture → 小齿轮设置：

   • Capture to active file：✅ 勾选
   • Insert after：# 参会人
   • Format：[[{{VALUE:name}}]]

2. 保存

Step3：添加第二步：Template（自动创建人物笔记）#

1. 点击 Template → 小齿轮设置：

   • 模板：模板/人物模板
   • 文件名：{{VALUE:name}}（和 Capture 变量完全一致）
   • 文件夹：人物

2. 保存

Step4：绑定 Macro 到主面板#

1. 返回 QuickAdd 主设置 → 选择 Macro → 名称：添加参会人 → Add
2. 选择刚配置的 宏-添加参会人 → 点亮小闪电

Step5：测试 + 快捷键#

快捷键：Ctrl/Cmd+Shift+3

效果：输入人名 → 自动加链接到会议笔记 + 自动创建人物模板笔记

---

功能 4：Multi 分类 —— 「指令收纳盒，不乱」#

官方定义：将指令分组为嵌套菜单，仅收纳，无执行功能

你的场景：指令太多，命令面板找起来麻烦

实操步骤#

1. QuickAdd 设置 → 选择 Multi → 名称：日常工作流 → Add
2. 按住指令旁三横线 → 拖拽到 Multi 文件夹里
3. 运行时：打开 QuickAdd → 先选分类 → 再选指令

官方提示：拖拽不灵敏为正常现象，新手可不用，不影响核心功能

官方核心语法大全（复制即用，新手必背）#

所有语法兼容 Capture/Template/Macro，官方标准格式：

官方加分项：支持模糊搜索文件、标签、标题，输入更快捷

高阶能力#

1. Package 跨库分享（官方独家）#

• 导出：设置 → Packages → Export → 生成 .quickadd.json 文件
• 导入：设置 → Import → 粘贴 JSON → 一键复用所有指令
• 用途：多设备同步、分享给好友、团队统一工作流

2. 外部触发（官方高级）#

• Obsidian URI：手机 / 其他 App 一键触发 QuickAdd
• QuickAdd CLI：电脑脚本、自动化工具调用

3. 脚本支持#

支持 JS 脚本 + QuickAdd API，可对接 AI、Dataview 等插件，实现极致自动化

新手必看！常见问题 & 排错（官方解决方案）#

1. 路径报错

   ✅ 原因：Mac/Windows 路径格式错

   ✅ 解决：Mac 无前导斜杠，Windows 从库根目录写

2. 变量不生效

   ✅ 原因：Macro 内变量名不一致

   ✅ 解决：Capture 和 Template 的 {{VALUE:xxx}} 必须完全一样

3. 指令不显示

   ✅ 原因：没点亮小闪电

   ✅ 解决：点击指令旁小闪电，变黄即可

4. 插入位置错

   ✅ 原因：Insert after 标题写错

   ✅ 解决：复制笔记里的完整标题，粘贴进去

---

官方推荐新手 3 个必做场景（直接抄作业）#

1. Capture：日记灵感捕获（入门首选）
2. Template：读书笔记一键创建（高频刚需）
3. Macro：参会人自动创建（进阶体验）

📌 最终总结（官方核心）#

QuickAdd 不是「花里胡哨的插件」，是Obsidian 效率底座：

✅ Capture = 快速记

✅ Template = 规范建

✅ Macro = 自动干

✅ Multi = 整齐收

新手记住一句话：先搞定 Capture + Template，90% 日常需求满足；再学 Macro，实现全自动自由！

附件：快速上手速查表#

QuickAdd 可以帮我们快速捕获、记录瞬间想法，同时能非常快速、方便地创建格式统一的笔记。

进阶用法上，QuickAdd 可以一键完成复杂多步骤操作。

对我个人而言，QuickAdd 能大幅提升笔记系统的自动化程度和便捷性。

好处：让我们专注于笔记思考、写作创作本身，不被创建笔记、打开笔记、关闭笔记等琐碎操作分散注意力。

本期视频会演示：如何使用 QuickAdd 插件，以及在哪些具体场景中应用它。接下来我们正式开始。

二、个人使用场景痛点#

我是日记重度使用者，一天中会把个人观点、突发想法、待备忘事项，先全部记录到日记里，空闲时再统一整理处理。

日常痛点场景：

正在处理读书笔记时，脑海突然冒出其他想法、待办事项。

常规操作：离开当前读书笔记 → 新打开页面 → 打开日记 → 找到对应位置 → 记录想法。

这类操作本身不复杂，但打乱原有工作流，必须中断当前读书笔记的编辑，这是我不想遇到的。

而 QuickAdd 里有一个 Capture 捕获功能，可以不离开当前笔记界面，直接把想法、观点记录到日记笔记的指定位置。下面实操演示配置与使用方法。

三、QuickAdd 四大核心操作总览#

进入 QuickAdd 设置界面，插件提供 4 种核心操作：

1. Template 模板
2. Capture 捕获
3. Macro 宏命令
4. Multi 分类文件夹

本期先演示 Capture，后续逐一讲解另外三种功能。

四、功能一：Capture 捕获功能 完整配置 & 实操#

1. 新建 Capture 命令#

1. 给命令自定义命名：方便后续设置调整时，记住该指令用途；示例命名：Capture - log in the daily
2. 命名完成点击 ADD choice，完成新建 Capture 指令
3. 点击指令旁小齿轮图标，进入详细设置界面

2. Capture 核心设置项讲解#

（1）选择保存位置#

• 选项 1：添加到当前笔记（勾选则内容存入正在编辑的笔记，本次不用）
• 选项 2：自定义文件路径（本次存入日记文件，手动输入路径）

路径写法区分系统：

• Mac OS：daily/{{date:YYYYMMDD}}
• Windows：需在最前面多加一根斜杠，从根目录开始定位

（2）文件不存在时自动创建#

• 个人习惯：不勾选（每天开机主动打开当日日记）

• 教学演示：勾选开启「文件不存在则自动创建」

  • 需选择是否套用固定模板：日记统一格式，勾选启用
  • 输入日记模板的文件路径

（3）Task 任务复选框#

是否把添加内容做成带方框的任务清单样式（可打勾 / 打叉），本次日记纯文字记录，不勾选。

（4）插入位置设置#

默认添加到文件末尾，本次需要插入到日记指定章节下方：

1. 打开日记模板（Command+O 调取）
2. 找到固定记录区域：what happened today
3. 复制该标题，回到 Capture 设置
4. 勾选 insert after，粘贴标题
5. 附加选项：是否插入到该标题下所有子标题末尾；本标题已是一级标题，无需勾选
6. 无需自动打开日记，不勾选 open 选项

（5）自定义捕获格式 Capture format#

设置内容插入日记的固定排版格式：

1. Markdown 无序列表：开头加 -

2. 插入实时时间：{{date:HH:MM}}

   • HH：24 小时制小时
   • MM：分钟
   • 可拓展加 :SS 显示秒

3. 插入自定义输入内容：固定变量 {{value}}

4. 提示文字设置：请输入你需要添加的内容（弹窗输入框提示语）

5. 设置后可实时预览最终排版效果，时间会随添加时刻自动更新

3. Capture 实际效果演示#

1. 回到 Obsidian 主界面，编辑读书笔记

2. 按下 Command+P，输入 quickadd，选择 run quickadd

3. 选中刚创建的 Capture - log in the daily 指令

4. 弹出输入框，输入内容（示例：this is a demo），确定

5. 无需离开当前读书笔记，系统自动：

   • 自动创建 12 月 13 号日记文件
   • 把内容带时间、无序列表格式，插入到 what happened today 板块下方

4. 优化操作：加入命令面板 & 设置快捷键#

1. 点击指令旁小闪电图标，变黄后该指令直接加入 Obsidian 命令面板

2. 无需再先打开 run quickadd，可直接在命令面板搜到指令，减少操作步骤

3. 进阶：进入 QuickAdd Hotkeys 快捷键设置

   • 选中对应 Capture 指令
   • 自定义快捷键（示例：Command+Shift+1）

4. 直接按自定义快捷键，弹窗输入内容，一键完成记录

五、功能二：Template 模板建笔记功能 完整配置 & 实操#

1. 适用场景#

Obsidian 中很多笔记需要统一格式：日记、读书笔记、会议记录等。

原生插件建统一笔记的痛点：

1. 新建空白笔记 → 插入预设模板
2. 按规则重命名笔记
3. 容易出现：忘记存放文件夹、忘记命名规则，需要翻看同类笔记对照

QuickAdd 的 Template 功能 完美解决，一键创建「套模板 + 规范命名 + 自动归类到指定文件夹」的笔记。

2. 新建 Template 命令#

1. 进入 QuickAdd 设置，选择 Template
2. 自定义命名：示例 template - ADD a book review
3. 点击 ADD choice，点亮小闪电加入命令面板

3. Template 核心设置项#

1. 模板路径：选择提前做好的读书笔记模板文件路径

2. 自定义笔记命名格式

   • 勾选启用自定义命名
   • 格式示例：读书笔记 {{value:请输入书名}}
   • {{value}} 为自定义输入变量，弹窗手动输入书名

3. 指定保存文件夹

   • 勾选固定存放路径，输入文件夹（示例：books 文件夹）
   • 输入路径后必须点 ADD 确认，支持添加多个备选文件夹
   • 可选子文件夹勾选：可二次选择存入子目录
   • 不勾选「保存到当前笔记同文件夹」

4. 创建后打开设置

   • 勾选 open，选择默认编辑模式（源码 / 预览 / 默认）
   • new split：是否分栏显示，无需则不勾选
   • 勾选 focus new pin：创建后自动聚焦到新笔记

4. Template 实操演示#

1. Command+D 打开命令面板，输入 book review 调出指令

2. 弹窗输入书名（示例：better angels of our nature）

3. 系统自动完成：

   • 套用读书笔记模板新建笔记
   • 按「读书笔记 + 书名」规范命名
   • 自动保存到 books 指定文件夹
   • 自动打开并聚焦新笔记

六、功能三：Macro 宏命令 进阶功能 完整配置 & 实操#

1. Macro 功能定义#

Macro 宏命令：把多个不同操作、指令按顺序组合，一次点击 / 一个快捷键，自动完成一连串多步骤操作，是 QuickAdd 进阶用法。

建议学习顺序：先熟练 Capture、Template，再上手 Macro。

2. 应用案例场景#

已有项目会议笔记，需要添加参会人：

• 已有笔记的参会人：直接双向链接添加

• 新参会人（无对应笔记）：

  常规操作：添加人名链接 → 点击新建空白笔记 → 套用人物模板 → 完善笔记，步骤繁琐。

用 Macro 可一键完成：添加参会人链接到会议笔记 + 自动创建人物模板笔记。

3. Macro 创建与配置步骤#

1. QuickAdd 设置界面，点击 manager macros
2. 新建 Macro，命名：macro - 添加一个参与者，点击添加
3. 点击 configure 配置宏命令步骤
4. 本案例分两个步骤组合：Capture + Template

步骤 1：配置 Macro 内的 Capture#

1. 命名简易标识，勾选 capture to active file（添加到当前会议笔记）
2. 指定插入位置：参会人 attendee 标题末尾
3. 自定义格式：[[{{value:name}}]]（双向链接格式）
4. 变量名固定为 name，后续 Template 需保持一致

步骤 2：配置 Macro 内的 Template#

1. 选择人物专用 people 模板路径
2. 笔记命名：直接复用变量 name（和 Capture 变量名必须一致，无需加中括号）
3. 指定人物笔记专属存放文件夹，步骤同 Template 常规设置
4. 选择是否自动打开新建的人物笔记
5. 可拓展添加 Obsidian 原生命令、脚本等，本案例无需额外添加

4. 绑定 Macro 到 QuickAdd 面板#

1. 回到 QuickAdd 主设置，选择 Macro 分类
2. 命名后点击 ADD，选中刚配置好的宏命令
3. 点亮小闪电加入命令面板
4. 自定义快捷键（示例：Shift+Command+2）

4. Macro 实操演示#

1. 在会议笔记界面，按下自定义快捷键 Shift+Command+2

2. 弹窗输入新参会人名（示例：LEO）

3. 系统自动完成：

   • 把 LEO 以双向链接形式插入会议笔记参会人板块
   • 自动套用人物模板，新建 LEO 专属笔记并归类到指定文件夹
   • 一步完成多步手动操作

七、功能四：Multi 分类整理功能#

1. Multi 相当于指令收纳文件夹，仅用于整理归类已创建的 Template、Capture、Macro 指令
2. 使用方法：新建 Multi 并命名，拖动现有指令收纳到对应分类下
3. 特点：仅做设置界面的整理归类，无实际编辑、执行功能，拖拽操作不够灵敏
4. 按需选择使用，不整理分类也不影响插件正常使用