Getting Started
QuickAdd turns your repetitive Obsidian actions - creating a note from a template, logging a line to your journal, running a script - into single commands you trigger with a hotkey. Set a workflow up once, then run it in a keystroke from anywhere in your vault.
New here? Build your first workflow below in about a minute.
Install QuickAdd
Section titled “Install QuickAdd”Install QuickAdd from Obsidian’s Community Plugins browser, then enable it.
If you cannot use the plugin browser, follow the manual installation guide.
Choose the right choice type
Section titled “Choose the right choice type”| If you want to… | Use this | Start here |
|---|---|---|
| Create a new note from a reusable file | Template choice | Template Choices |
| Append text to a journal, log, task list, or existing file | Capture choice | Capture Choices |
| Run one or more Obsidian commands, scripts, or choices | Macro choice | Macro Choices |
| Group choices into a nested menu | Multi choice | Multi Choices |
| Share configured workflows across vaults | Package | Share QuickAdd Packages |
Most workflows start with either a Template choice or a Capture choice. Add a Macro choice when you need scripting, multiple steps, or data from another plugin or API.
First workflow
Section titled “First workflow”Let’s build a capture that adds a timestamped line to your daily journal. It takes about a minute.
- Open Settings → QuickAdd. Type a name like
Add to journal, choose Capture in the dropdown, and click Add Choice. - Click the gear (⚙) next to your new choice to open its settings.
- Set Capture To to
Journal/{{DATE}}.md- the note today’s entries land in. - Turn on Capture format and enter
- {{DATE:HH:mm}} {{VALUE}}- the shape of one entry. - Close the settings. Open the command palette (Ctrl/Cmd+P), run
QuickAdd: Run, pick
Add to journal, and type your entry.
QuickAdd writes a line like - 09:42 Standup moved to Wednesday into today’s
journal note, without opening it. Once it works the way you want, give it a
hotkey from the ⚡ icon next to the choice or Obsidian’s Hotkeys settings.
The {{DATE}} and {{VALUE}} above are format syntax:
placeholders QuickAdd fills in each time you run the choice. There are
placeholders for dates, your answers, links, clipboard content, and more. When a
prompt asks you for text, the suggester system lets you
type [[ or # to pull in a file, tag, or heading from your vault.
Common paths
Section titled “Common paths”I want examples first
Section titled “I want examples first”Use the examples overview to pick a complete workflow by choice type, difficulty, prerequisites, and outcome.
Good first examples:
- Capture: Add entries to your daily note
- Template: Add an Inbox Item
- Macro: Book Finder
- Capture: Canvas Capture
I want to automate with scripts
Section titled “I want to automate with scripts”Start with the scripting overview, then move to User Scripts and the QuickAdd API reference when you need exact method details.
I want to call QuickAdd from outside Obsidian
Section titled “I want to call QuickAdd from outside Obsidian”Use Obsidian URI for URI-triggered workflows, or the QuickAdd CLI for shell scripts and external automation.