Custom Todos
Shortcuts
- TODO Task Label Prefixes & Variables
TODO task labels support special prefixes and variables that control how tasks are rendered in the UI.
- Prefixes
Prefixes are detected by examining the **first character** of the label after trimming leading whitespace.
- `.` (Dot) – Inline/Child Tasks
Prefix a task label with `.` to make it an **inline child** of the preceding non-dot task. Child tasks are displayed in a grid row alongside their parent, creating a compact horizontal layout.
- Behaviour:**
- The `.` prefix is stripped from the displayed label - The task is grouped with the previous non-dot task as a child - Displayed in a shared grid row (parent + children side by side) - Checkbox is still shown (can be checked/unchecked) - If a dot-prefixed task appears without a preceding parent, it is treated as a regular individual task
- Example:**
``` Monday Breakfast .Lunch .Dinner ``` Renders as a single row: `[☐ Monday Breakfast] [☐ Lunch] [☐ Dinner]`
- `|` (Pipe) – Label-Only (No Checkbox)
Prefix a task label with `|` to render it as **plain text without a checkbox**. Useful for section headers, notes, or informational text within a todo list.
- Behaviour:**
- The `|` prefix is stripped from the displayed label - No checkbox is rendered - The item does not count toward the completed/total counter
- Example:**
``` |Important Notes Attend all morning sessions |Evening Activities ``` Renders as: ``` Important Notes (plain text, no checkbox) [☐ Attend all morning sessions]
Evening Activities (plain text, no checkbox) ```
- Date Variables
Task labels support the `Template:EventDate` variable, which is replaced with the event's start date displayed as day and month numbers (e.g., `16/06`).
- Basic Usage
| Variable | Replaced With | |---|---| | `Template:EventDate` | Event start date (e.g., `16/06`) |
- Offsets
You can add or subtract days from the event date using `+` or `-`:
| Variable | Replaced With | |---|---| | `Template:EventDate+1` | Event start date + 1 day | | `Template:EventDate-1` | Event start date − 1 day | | `Template:EventDate+3` | Event start date + 3 days | | `Template:EventDate-2` | Event start date − 2 days |
Whitespace inside the braces is tolerated:
- `Template:EventDate + 1` → same as `Template:EventDate+1` - `Template:EventDate- 2` → same as `Template:EventDate-2`
Unknown variables (anything other than `EventDate`) are left as-is.
- Example:**
``` Template:EventDate Check-in at hotel Template:EventDate+1 Follow-up meeting ``` Renders as: `16/06 Check-in at hotel`, `17/06 Follow-up meeting` (assuming event starts June 16)
- Combining Prefixes and Variables
Prefixes and date variables can be used together:
``` |Schedule for Template:EventDate Morning briefing . Afternoon workshop . Evening networking ```
---
Once you're satisfied with this documentation, please **toggle to Act mode** so I can write it to a file for you.