All Plugins

๐Ÿ“’ Templating

Templating Plugin for NotePlan

v2.0.20by Mike Erickson ( codedungeon)

Templating Command Bar

๐Ÿงฉ Templating plugin for Noteplan

Hereโ€™s a grouped release announcement message summarizing the new features and improvements in the latest Templating plugin updates (v2.0.0โ€“2.0.8), leaving out bug fixes:


๐Ÿ†• Templating Plugin v2.0.x โ€” Major Features & Enhancements

Weโ€™re excited to announce a major series of updates to the Templating plugin, packed with powerful new features, workflow enhancements, and developer tools. Hereโ€™s whatโ€™s new:


๐Ÿ“„ Template Note Creation & Insertion

  • You can now use InsertTemplate or AppendTemplate to:

    • ๐Ÿ†• Automatically create a new note in the specified folder when used on a blank note.
    • ๐Ÿ“ Prompt to move the current note to the target folder if it's not blank.
  • Support for newNoteTitle argument and JSON vars for better Shortcuts integration.

  • templateAppend command improvements for easier testing.


๐Ÿง  Smarter & More Flexible Template Tags

  • New tag functions:

    • getValuesForKey: retrieve all values for a specific frontmatter key.
    • promptKey: interactive user prompts with folder filtering.
    • getNote: fetch notes by title, filename, or ID.
  • <select XXX> now allows for folder selection from filtered list.

  • Support for adding properties with --- block in templates.


๐Ÿ“… Date & Time Enhancements

  • date.daysUntil added.
  • formattedDateTime now supports both strftime and moment.js.
  • now works correctly with offsetDays.
  • date8601 bug fixed.
  • Updated to match NotePlanโ€™s week numbering and week start settings.

๐Ÿงพ Note & Task Utilities

  • New functions in NoteModule:

    • note.currentNote()
    • note.getRandomLine()
    • openTasks, completedTasks, openChecklists, completedChecklists
  • Added eventDate and eventEndDate for use with Meeting Notes.

  • Stoic quotes, Bible verses, journaling questions now available in web.services.


๐ŸŒ Web Services Enhancements

  • web.services now globally accessible with automatic await.
  • Improved timeout messages for advice, verse, quote, and weather services.

๐Ÿ”— Documentation

  • All plugin documentation links now point to the new documentation site.

Thanks to everyone who submitted feature requests, especially @jgclark and Tim Shaker! As always, feedback is welcome.


Templating is a template language plugin for NotePlan that lets you insert variables and method results into your notes. It will also let you execute custom JavaScript constructed in the templates providing a rich note taking system.

Documentation

๐Ÿ“– This README provides a quick overview of Templating, visit Templating website for comprehensive documention.

NOTE: Start Here: Templating Documentation

Commands

All commands can be invoked using the NotePlan Command Bar (Command-J then /) which NotePlan has reserved for plugin activation. Or by selecting ๐Ÿงฉ Templating from the Plugins menu)

Templating Command Bar

Once the command bar is displayed, you can continue typing any of the following commands to invoke the appropriate plugin command. In some case where specifically noted, you can alternately invoke the plugin command at the current insertion pointer within your document.

๐Ÿ“– Visit Templating website for comprehensive documention

CommandAvailable InlineDescription
np:appendYesAppends selected template at end of current note (will show list of all available templates)
np:insertYesInsert selected template at cursor (will show list of all available templates)
np:invokeYesInvoke Template Command, using location key in template to determine injected template
contents into current
np:newYesCreates a new note from selected template and supplied note name
np:qtnYesInvokes Quick Note Generation (displays list of all type: quick-note)
np:updateYesInvokes settings update method
np:versionYesDisplays current Templating version

License

Copyright ยฉ 2022 Mike Erickson Released under the MIT license

Credits

Codedugeon Toolbox for NotePlan written by Mike Erickson

E-Mail: [email protected]

Support: https://github.com/NotePlan/plugins/issues

Twitter: @codedungeon

Website: codedungeon.io

Quick Stats

Commands
19
Settings
22