Portfolio: Tasks and Simple Projects
Yes, Markdown supports tasks (minimally), but you need more to make them work.
Basic Taskology
Tasks are a built-in feature of the Markdown text formatting language. A text line like this:
- [ ] this is something to do
will be rendered in core Obsidian (without any plugins) in read or edit mode, as this
Click on the box to convert the ‘state’ of the task from ‘open’ to ‘closed’ or ‘completed’.
Also, tasks can be managed in lists:
To create a bit more structure, tasks can be indented, making them an addressable group, not just a series of individually addressable tasks:
Notice that the top-most task, which a user might want to represent completing the list, does not automatically check itself off when the others are checked.
But the group of tasks is now a group with a shared block reference:
This leads to this, once applied:
Note the ‘^pzbs7r’ (which can be manually edited to be easier to remember). I can use that in block reference from any note, like this:
For many basic purposes — like creating a grocery list — that level of ‘project management’ may be sufficient. But for all serious work, more is needed.
Extended Task States
Extended task states are the first significant enhancement of tasks that I rely on in Portfolio. Instead of being limited to just ‘open’ and ‘closed’, it’s possible to have an extended list of states using the Minimal theme and others. Here's the list of alternative states that I use at this time in Portfolio, grouped by classes:
important
- [!] most important, urgent - only a few per formal project
- [>] queued - pull from queued and make urgent
active
- [/] working - in process
- [<] waiting - waiting on other tasks or people
- [ ] open - active but not started yet
inactive
- [?] maybe - unsure if it should be undertaken
- [i] info - supporting other present or future activities
- [-] - canceled
- [x] - closed, done, completed
And here’s how they render with the Minimal theme:
Minimal supports more task states. Still, I have settled on this collection, and the groups allow me to array them when using queries to collate tasks based on project and other knowledge base taxa (see Portfolio: A Knowledge Base Built on Files for a grounding on Portfolio’s knowledge base).
Tasks and Projects Are All in Your Head
Task lists are not named but are implicitly activities comprising a project. The project could involve only a single task or a bunch of them. One convention is to use the parent task to indicate the project:
There is only one active task in this ‘project’; everything else is on hold until that can be done. Note I had to manually edit the states of all the tasks to indicate their specific states, but there are plugins to help with that.1
Projects like these might be considered ‘simple’ projects: they have no other organizational overhead. There are all sorts of things in Obsidian that are simple or implicit projects. Whenever I clip something from the web into my vault, for example, there is an implied project to read (and annotate) that note and maybe take other actions, like writing something about it.
Generally, though, I tend not to rely much on simple projects because the informality and the number of projects that may be created over months or years make keeping track of things difficult.
In the next installment in the series, I will dig into a more formal structured model for managing more complex projects that form the heart of project management in Portfolio.
…
Before closing, here is a note on breaking one limitation on Obsidian’s tasks. Like Markdown, Obsidian requires that tasks start with the first non-blank letter on a line of text. But what if we could ignore that limitation and create tasks anywhere on a line, so long as the convention of a specific series of characters is retained, they can be found by search?
For example, the ‘fix the fence’ simple project could all be placed on a single line, carrying the same meaning:
Or, I might want to add a task to a block in some note by embedding the task in a footnote:
In read mode, the task state is not rendered prettily, but it can still represent a task in the reader’s mind2:
A search for all tasks regarding ‘forecasting’ would yield a list of such tasks, including the one from the footnote:
As we shall see in the next installment — more complex project management (or ‘missions’) — findability is more important than almost everything else.
Keep reading with a 7-day free trial
Subscribe to Workings to keep reading this post and get 7 days of free access to the full post archives.