Obsidian 学习笔记

Appearance

QuickAdd 速查表 ​

QuickAdd 是 Obsidian 最强大的效率插件之一，支持快速捕获、模板应用和宏自动化。

基本设置 ​

启用插件 ​

  1. 设置 → 第三方插件 → 浏览 → 搜索「QuickAdd」
  2. 安装并启用
  3. 点击齿轮图标打开设置

管理界面 ​

操作说明
+添加新选择
⚙编辑选择设置
🗑删除选择
⚡运行选择
拖拽调整顺序

选择类型 ​

类型说明用途
Template模板选择从模板创建笔记
Capture捕获选择快速添加内容到笔记
Macro宏选择自动化多步操作
Multi多重选择组合多个选择

Capture 捕获 ​

基本配置 ​

设置说明
Capture to目标笔记路径
Capture format捕获格式
Insert after在指定行后插入
Prepend在文件开头插入
Task添加为任务
Line break after插入后换行

捕获格式变量 ​

变量说明示例输出
`{{value}}`用户输入值输入的文本
`{{DATE}}`当前日期2024-01-15
`{{TIME}}`当前时间14:30:00
`{{DATE:format}}`自定义日期`{{DATE:YYYY年MM月DD日}}`
`{{TITLE}}`当前笔记标题我的笔记
`{{CLIPBOARD}}`剪贴板内容复制的文本
`{{SELECTED_TEXT}}`选中的文本选中的文字
`{{FILENAME}}`当前文件名MyNote
`{{CURRENTPATH}}`当前文件路径Notes/MyNote
`{{LINKCURRENT}}`当前文件链接`[[MyNote]]`

捕获示例 ​

添加任务到今日日记：

text
- [ ] {{value}} ⏫ 🅰️ {{DATE}}

追加会议记录：

text
## {{TIME}} 会议
- **内容**: {{value}}
- **日期**: {{DATE}}

收集想法到 Inbox：

text
{{value}}

目标文件：Inbox/想法收集.md

Template 模板 ​

基本配置 ​

设置说明
Template Path模板文件路径
File Name新文件名
Open创建后打开
Folder存放文件夹

模板变量 ​

Template 类型继承 Capture 的所有变量，额外支持：

变量说明
`{{NAME}}`新文件名
`{{VALUE}}`QuickAdd 输入值

模板文件示例 ​

markdown
---
title: {{NAME}}
date: {{DATE:YYYY-MM-DD}}
tags: [{{VALUE}}]
---

# {{NAME}}

## 背景

{{CLIPBOARD}}

## 笔记

Macro 宏 ​

创建宏 ​

  1. 添加 Macro 类型选择
  2. 点击齿轮图标
  3. 添加步骤

可用步骤 ​

步骤说明
Template应用模板
Capture执行捕获
Open打开笔记
Command执行 Obsidian 命令
User Script执行 JavaScript 脚本
Wait等待指定时间
Choice嵌套选择

JavaScript 脚本 ​

在宏中运行自定义 JavaScript：

javascript
// QuickAdd User Script
module.exports = async (params) => {
  const { app, quickAddApi } = params;

  // 获取用户输入
  const title = await quickAddApi.inputPrompt("输入标题");

  // 获取选择
  const category = await quickAddApi.suggester(
    ["技术", "生活", "工作"],
    ["tech", "life", "work"]
  );

  // 操作文件
  const content = `# ${title}\n\n分类: ${category}\n日期: ${new Date().toLocaleDateString()}`;

  await app.vault.create(`Notes/${title}.md`, content);

  new Notice(`已创建: ${title}`);
};

QuickAdd API ​

javascript
// 输入对话框
const text = await quickAddApi.inputPrompt("请输入", "默认值");

// 密码输入
const password = await quickAddApi.passwordPrompt("请输入密码");

// 确认对话框
const confirmed = await quickAddApi.yesNoPrompt("确定吗？");

// 选择器
const choice = await quickAddApi.suggester(
  ["选项1", "选项2", "选项3"],
  ["value1", "value2", "value3"]
);

// 获取光标位置
const cursor = params.variables.cursor;

// 获取选中内容
const selected = params.variables.selectedText;

Multi 多重选择 ​

创建多重选择 ​

  1. 添加 Multi 类型选择
  2. 拖入已创建的其他选择
  3. 按顺序执行

示例工作流 ​

text
Multi: 日常启动
├── Capture: 打开今日日记
├── Template: 加载每日模板
└── Macro: 执行初始化脚本

日期格式 ​

使用 Moment.js 格式：

格式输出说明
YYYY2024四位年份
YY24两位年份
MM01两位月份
M1月份
DD15两位日期
D15日期
HH1424 小时制
hh0212 小时制
mm30分钟
ss45秒
dddMon缩写星期
ddddMonday完整星期
YYYY-MM-DD2024-01-15标准日期
YYYY-MM-DDTHH:mm2024-01-15T14:30ISO 格式

设置文件 ​

QuickAdd 的配置存储在：

text
.obsidian/plugins/quickadd/data.json

导出/导入设置 ​

  1. 打开 QuickAdd 设置
  2. 点击「Export」导出 JSON
  3. 在新设备点击「Import」导入

常用场景 ​

每日日记捕获 ​

配置值
类型Capture
Capture to`Daily/{{DATE:YYYY-MM-DD}}`
格式`- [ ] {{value}} ⏫ 📅 {{DATE}}`
Insert after## 今日待办
Line break✅

快速添加 Zettelkasten 笔记 ​

配置值
类型Template
Template PathTemplates/Zettelkasten.md
File Name`{{DATE:YYYYMMDDHHmm}} {{VALUE}}`
FolderZettelkasten
Open✅

周报生成（宏） ​

text
1. Capture: 收集本周完成的任务
2. User Script: 汇总任务列表
3. Template: 应用周报模板
4. Command: 打开创建的周报

快捷键设置 ​

  1. 设置 → 快捷键
  2. 搜索「QuickAdd」
  3. 为常用选择设置快捷键

推荐快捷键：

操作快捷键
打开 QuickAddCtrl/Cmd + Q
添加任务Ctrl/Cmd + Shift + T
新建笔记Ctrl/Cmd + Shift + N

常见问题 ​

捕获后没有内容？ ​

  • 检查捕获格式是否为空
  • 确认目标文件路径正确
  • 检查 Insert after 行是否存在

宏中脚本不执行？ ​

  • 确保脚本语法正确
  • 检查 module.exports 导出
  • 查看开发者控制台错误信息

中文文件名问题？ ​

  • 使用 `{{NAME}}` 变量时中文可能需要编码
  • 建议使用日期作为文件名前缀

相关资源 ​