Basic SyntaxTable of Contents
Here is a task with all the items. Items are divided by space and symbols. The items must always be in this order.
During task creation, syntax will be something like this:
(A) 2024-10-23 Do this task for +KomoDoApp @Akademy due:2025-12-10 link:https://kde.org
Here is the explanation for the items:
| Item | Description |
|---|---|
| (A) | Priority of the item, from A to Z. Optional. Will be removed and turned into pri:A when task is completed. |
| 2024-10-23 | Creation date. Optional, but recommended. |
| Do this task for +KomoDoApp @Akademy | The description of the task. Projects and contexts can be marked anywhere within the description. |
| +project | Items starting with + are projects: What project is this task related to? For example: +Application, +Linux. Optional. |
| @context | Items starting with @ are contexts: In what context (place, situation) should this task be worked with? For example: @Home, @Work, @Cafe. Optional. |
| key:value | Key:Value pairs that will be parsed by KomoDo. Can be used for links, such as link:https://kde.org. Optional. |
| due:2025-12-10 | Special Key:Value pair that KomoDo parses as a due date for the task. It only supports date, not time. Optional. |
When task is marked as completed, KomoDo will format the task like this:
x 2025-12-30 2024-10-23 Do this task for +KomoDoApp @Akademy due:2025-12-10 link:https://kde.org pri:A
Most items stay the same, but there are couple changes:
| Item | Description |
|---|---|
| x | This marks the completion. If there is no x, task is incomplete. Must be lowercase. |
| 2025-12-30 | First date is completion date, but only if the task is marked as completed. Optional, but recommended. |
| 2024-10-23 | Second date is the creation date. Must be specified if the completion date is! |
| pri:A | Priorities of completed tasks will be removed from start and appended into the end of task as pri:Priority. |