Creating Notes

Summary

While we call it the Lookup Bar, you can also use it to create notes that don't exist. When you lookup for a note that hasn't been created, Dendron will create it for you.

To try it yourself, bring up the lookup bar. Type hello and hit Enter.

When looking up a note that does NOT have any special characters [" ","|","*","^","$","!","=","'"] (note: space is deemed as special character), and does NOT yet exist, Create New will bubble up to the top of query results to make it convenient to create a new note.

Creating Special Notes

Dendron has builtin notion for certain types of notes with pre-defined hierarchies. These notes can be created by toggling the corresponding note button on the lookup menu or by using the respective builtin shortcuts.

  • values:
    • none (default): create a regular note
    • journal: create a journal note (cmd/ctrl + shift + j)
    • scratch: create a scratch note (cmd/ctrl + shift + s)

Creating Notes with a Selection

If you have text highlighted while creating a new note with a lookup, the new note will be created using the text selected. How the text will be used depends on the dendron.defaultLookupCreateBehavior setting.

  • values:
    • selectionExtract (default): create new note with text from the old note. remove text from the old note
    • selection2link: create new empty note and turn selection into a link referencing the old note

Vault Selection for New Notes

If you have multiple vaults in your workspace, you can control the behavior of which vault your new note will be placed in:

Vault Location when Creating a Note

When creating a note in lookup, Dendron will try to create your note in the correct vault. By default, it will place the note into the same vault as the currently opened note. But if it detects that the new note matches an existing hierarchy in a different vault, you will get prompted to pick the destination vault:

Prompt for Vault Selection Each Time

lookupConfirmVaultOnCreate

This setting is scheduled for deprecation šŸ“†

Use confirmVaultOnCreate instead.

With this set, you will be prompted to select the vault location each time you create a note when you have multiple vaults in your workspace.

To enable, add lookupConfirmVaultOnCreate: true in the dendron configuration. Instructions to do so below.

  1. Dendron: Configure (yaml)

  2. add lookupConfirmVaultOnCreate: true so your configuration looks like the following:
version: 0
...
lookupConfirmVaultOnCreate: true