Templater - chrisgurney/obsidian-note-toolbar GitHub Wiki

Install and enable the Templater plugin ↗ and use Note Toolbar to insert templates, create new notes from specific templates, and to execute Templater commands and files.

Note Toolbar's Scripting option must be enabled in order to use this feature.

Use Templater commands in labels, tooltips, and URIs, to create dynamic toolbars.

For example, set your label to <%tp.date.now("MMM Do")%> to show today's date. Alternately use this syntax: {{tp: tp.date.now("MMM Do")}}

Note that the entire label/tooltip/URI must start with a <% and end with a %>. If you wish to include a fixed string as part of the output, the expression must output that string.

• For example, this will not work: Daily Notes/<% moment(tp.file.title, ... %>
• Instead, the command will need to append the string: <% "Daily Notes/" + moment(tp.file.title, ... %>

After creating a new Templater toolbar item, select from one of the below functions.

• Inserts the provided template in the current file, at the current cursor position.
• Uses the append_template_to_active_file API method.

• Creates a new note from the provided template.
• Optionally specify an output folder and filename (without the .md extension). Use a Templater command in this field to create a dynamic filename.
• Optionally select a command to run after execution, for example: Files: Reveal current file in navigation.
• Uses the create_new_note_from_template API method.

• Executes the provided Templater command and returns the result.
• The tags <% and %> are optional.
• Execute user scripts with tp.user...
• Uses the parse_template API function.

Example command:

tp.file.creation_date()

• Executes the provided file and returns the result.
• Make sure you include tp in the function's signature in order to use Templater's API within your scripts.
• Uses the read_and_parse_template API method.

Example file:

/**
 * Adds a date stamp to the filename of the current file.
 */
module.exports = async function FileRename(tp) {
    tp.file.rename(tp.file.title + ' ' + tp.date.now());
}

For Note Toolbar Callouts, use these data attributes:

Example:

> [!note-toolbar] Templater Toolbar
> - [Create from Template]()<data data-templater-obsidian="createFrom" data-src="Templater/Basic Template.md" data-dest="&lt;%&quot;Basic &quot; + tp.file.last_modified_date(&quot;yyyy-MM-dd&quot;)%&gt;"/>

For how output and errors are handled, see Executing scripts.