You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/settings/task-defaults.md
+84-56Lines changed: 84 additions & 56 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -123,102 +123,111 @@ The system prevents file overwrites by checking for existing files and showing e
123
123
124
124
When using the **custom** filename format, you can create templates using variables that are replaced with actual values when tasks are created.
125
125
126
+
> **Recommended syntax:** Use double braces `{{variable}}` for consistency with body templates. Single braces `{variable}` are supported for backwards compatibility but are deprecated.
For ICS event notes, additional variables are available:
213
222
214
-
-`{icsEventTitle}` - Event title from ICS calendar
215
-
-`{icsEventLocation}` - Event location
216
-
-`{icsEventDescription}` - Event description (truncated to 50 characters)
217
-
-`{icsEventTitleWithDate}` - Event title with formatted date
223
+
-`{{icsEventTitle}}` - Event title from ICS calendar
224
+
-`{{icsEventLocation}}` - Event location
225
+
-`{{icsEventDescription}}` - Event description (truncated to 50 characters)
226
+
-`{{icsEventTitleWithDate}}` - Event title with formatted date
218
227
219
228
### Important Notes
220
229
221
-
-**Single Braces**: Filename variables use single braces `{variable}` while folder variables use double braces `{{variable}}`
230
+
-**Unified Syntax**: Both filename and body templates now use double braces `{{variable}}`. Single braces `{variable}` are supported for backwards compatibility but deprecated.
222
231
-**Sanitization**: All variables are automatically sanitized to be safe for filenames (invalid characters removed)
223
232
-**Empty Values**: If a property doesn't have a value, the variable is replaced with an empty string
224
233
-**Character Limits**: Filenames are limited to 255 characters on most systems
@@ -264,6 +273,25 @@ For detailed reminder documentation, see [Task Reminders](../features/task-manag
264
273
265
274
TaskNotes supports **Templates** for both the YAML frontmatter and the body of your task notes. You can use templates to pre-fill common values, add boilerplate text, and create a consistent structure for your tasks. Templates can also include variables, such as `{{title}}`, `{{date}}`, and `{{parentNote}}`, which will be automatically replaced with the appropriate values when a new task is created.
266
275
276
+
### Unified Template Variables
277
+
278
+
Body templates now support the same variables as filename templates. All variables listed in the [Filename Template Variables](#filename-template-variables) section above are available in body templates, including:
279
+
280
+
- All date/time variables (`{{year}}`, `{{month}}`, `{{timestamp}}`, etc.)
281
+
- All title variations (`{{titleKebab}}`, `{{titleSnake}}`, etc.)
0 commit comments