Obsidian QuickAdd

共计 2628 个字符，预计需要花费 7 分钟才能阅读完成。

QuickAdd 比前面几种插件略微复杂一些，不过一旦掌握其使用方法后，能有效减少不少重复的工作。

那么 QuickAdd 有什么用呢？如其名一样，QuickAdd 常用于快递创建文件并设置一系列参数。如果我想通过书籍模板在“2023 年阅读书籍”目录中创建关于《如何阅读一本书》这本书的信息，并设置 status、priority 和截止日期等参数，最后将该书添加到 Kanban 中。
正常情况下，这个流程大致如下：

1. 在“2023 年阅读书籍”目录中创建新文件，并命令为《如何阅读一本书》
2. 参考这里插入书籍模板
3. 修改 status、priority 等元信息
4. 填充其他信息
5. 在 Kanban Todo 栏中创建卡片，并添加该书

如果使用 QuickAdd 的话，流程可优化为如下步骤：

1. 通过 ⌘+p 快捷键打开命令输入框，然后输入 qa（或 quickadd 等）来调用 QuickAdd，选择 New Book（需自行设置，见下文），选择 status 和 priority 等信息的预设值即可。

可以看到，通过 QuickAdd 我们不需要去寻找“2023 年阅读书籍”这个目录，不需要打开文件来填写 status 和 priority 等信息的值，也不需要再跑到 Kanban 中添加该书信息。这一切均可通过 QuickAdd 来自动完成。

那么如何使用 QuickAdd 呢？本文先对 QuickAdd 做了大概介绍，然后再说下如何使用 QuickAdd。

简介

QuickAdd 将创建文件的过程称为 Choice，根据不同行为目前有四类 Choice：

• Template Choice：用于插入模板，相较于默认插入模板的行为而言，通过 QuickAdd 插入模板有快递设置一些必要的信息。
• Capture Choice：用于将输入的文本拷贝到指定文件中。
• Multi Choice：Choice 菜单，用于将多个功能相近的 Choice 组合放在一个 Choice 中展示。
• Macro Choice：通过宏来构建任意工作流，用于创建多步骤的工作流。

Choice

Template Choice

Template Choice 可设置模板目录，文件名，文件所属目录等。可用于创建每日行程，单词，书籍信息，菜谱等场景。

Capture Choice

Template Choice 用于将指定文本输入到指定文件中。可用于写每日碎念（当然也可使用 Obsidian Memos :smile:），将想法记录到素材库，抓取文章内容到待读列表等等。

Multi Choice

用于将多个相似的 Choice 组合放在一个目录中。使用起来很简单，如下：

Macro Choice

Macro Choice 用于构建工作流，其由一个或多个 Template Choice 或 Capture Choice 组成，用来简化重复工作的执行流程，可以说该 Choice 是 QuickAdd 的精华。

格式化语法

在创建 Choice 时，无论是文件名、文件内容还是元信息，经常需要填入一些固定内容，据此 QuickAdd 提供了如下语法来帮助用户创建 Choice：

• {{DATE}}
  以 YYYY-MM-DD 的形式输出当前日期。
  • 偏移日期：可以使用 {{DATE+offset}} 的形式输出偏移日期，如 {{DATE+7}} 表示一周后，{{DATE+-3}} 表示 3 天前。
  • 日期格式：使用 {{DATE:<DATEFORMAT>}} 来指定日期格式。
    如下是一些示例：
  • {{DATE:YYYY/MM/DD HH:mm:ss}}：输出格式类似于 2023-02-02 15:41:25 的日期；
  • {{DATE:X}}：输出 Unix 时间戳；
  • {{DATE:[Today is] dddd}}}：输出 Today is Thursday；
  • {{DATE:[Tomorrow is] YYYY/MM/DD+1}}：输出 Tomorrow is 2023/02/03；
• {{VDATE:<variable name>, <date format>}}
  若开启了 Natural Language Dates 插件，则可以代表其语法来输入时间，如若在模板中添加 {{VDATE:DueDate,YYYY-MM-DD}}，那么在 DueDate 提示框中输入 today 和当前日期效果是一样的。
• {{VALUE}} 和 {{NAME}}
  两者等价，用于变量赋值。当变量较多时，最好通过 {{VALUE:<variable name>}} 来显示变量名。
• {{LINKCURRENT}}
  表示当前页面的链接。
• {{MACRO:<MACRONAME>}}
  执行宏并插入返回值。
• {{TEMPLATE:<TEMPLATEPATH>}}
  插入模板，支持 Templater 语法。
• {{MVALUE}}
  插入 LaTeX 数学公式。

应用

这里以上面 New Book 为例说下 QuickAdd 的使用过程。

安装

参考安装社区插件，搜索 quickadd 安装，然后点击开启即可。

创建 Choice

如果需要创建文件并添加到 Kanban 中，因此需要使用 Macro Choice，设置过程如下：

1. 打开 QuickAdd 配置，点击 Manage Macros，输入 AddBookMacro 并点击 Add Macro 来创建名为 AddBookMacro 的宏。
2. 添加 Template Choice：点击 AddBookMacro 的 Configure 按钮，点击 Template 按钮，点击新 template 右侧的配置按钮，配置如下：

• 设置模板路径
• 设置文件名：{{VALUE:Book Name}}
• 设置文件保存路径
  如下图：
  
  设置完成后关闭 Template Choice。

3. 添加延时：点击 Template 按钮旁边的 Add wait command 按钮（即闹钟图标按钮）
4. 点击 Capture Choice：点击 Capture 按钮，然后点击该 Capture Choice 右侧的配置按钮进行配置：

• 设置目标文件名
• 设置插入位置，这里根据 Kanban 中的几个标题进行设置，如 Todo，In Progress 和 Done 等
• 设置抓取格式为 - [ ] [[{{VALUE:Book Name}}]]
  如下图：
  

5. 在 QuickAdd 配置页面，输入 New Book，并选择 Macro，点击 Add Choice 创建 New Book 这个 Macro Choice。若有多个 Macro Choice，则需要点击该 Macro Choice 来关联已创建的 Macro（即 AddBookMacro 宏）。

使用

通过 ⌘+p 打开命令窗口，输入 quickadd，选择刚创建的 New Book，然后添加信息，演示效果如下：

本文仅对 QuickAdd 做了一个简单的说明，更多使用案例可以参考这里。