Using Drafts 5 Taskpaper with OmniFocus

Apr 19

OmniFocus Taskpaper Action Group for Drafts I have created an action group for Drafts 5 which is meant to help you create Taskpaper formatter projects or tasks and then send it all along to OmniFocus afterwards.

The first thing you will want to do is to create a Draft with the Taskpaper format. This is the last but one action in the action group - the reasoning being you're not likely to need it as often as some of the others! It simply opens a new Drafts with the format set to taskpaper - you can do this yourself by tapping the + icon if you're in a Draft, and then using the Aa button to set the Syntax Highlighting of the current draft to Taskpaper.

The first action in the group is a tab, this is for iPhone users and iPad users without an external keyboard and it simply inserts a tab wherever the cursor currently is.

The next action is Placeholder, if you have text selected it will wrap the text in «» characters, and if no text is selected it will insert them. This is ideal for dates in templates you will want to update later.

The first Due action takes advantage of the natural language parsing that OmniFocus has available via URL Scheme. Again, if you have text selected it will wrap it in @due(), otherwise that will be inserted empty for you to fill in the brackets.

The Defer, Estimate, Tags, and Context actions work the same way as Due. Tags and context are both available so if you're on the OmniFocus 3 beta or simply want to prepare your templates to work for both 2 and 3 you can already.

Tags (suggest) offers a list of tags for you to choose from, allows you to choose more than one of them, and inserts them inside @tag(). You will need to edit this script to make it work for you - the "one", "two", "three" is the part that needs changing. Bear in mind that a long list of tags will be annoying to look through most likely. If you want any tags to be pre-selected for you (e.g. you usually add the evening tag to tasks created via Drafts), you can put that into the [] after the tag list.

Tag suggest script detail;

Autodone asks you if you want the task or project to be automatically completed when the tasks inside of it are completed and inserts @autodone(true) or @autodone(false)as per your choice.

The Repeat Method allows you to choose how the task should repeat, and inserts @repeat-method(fixed), or whichever the relevant choice is.

The Repeat Rule is very simple, but allows you to choose if a task should be repeated every X days, weeks, months, or years.

Parallel works the same way Autodone does, if the project should be parallel (actions able to be worked on at the same time) then @parallel(true) is inserted, if not @parallel(false) appears.

Flagged just inserts @flagged when it is run - which adds a flag to a task.

Due and Defer are here again - but this time with date and time pickers. This allows you to choose an exact date and time when your task or project is due. I've used European date formatting, but you can modify that to any other date formatting by replacing the "dd-MM-yyyy hh:mm" (for example in North America you might prefer "MM/dd/yyyy hh:mm").

Estimate makes another appearance, this time it asks you to choose how many minutes, hours, days or weeks something will take and fills in the @estimate() for you.

The final action in this set is Taskpaper to OF. This will ask you where you want to save your Draft (as a new project, a new project in a folder, as tasks in a specifc project, or the inbox), go through any «placeholders» you have and help you replace them (important cat is always going to be replaced with whatever you tell the script when it asks you about it, so make sure you to use unique placeholders where necessary!), and then send everything off to OmniFocus. Once you return if it did have placeholders to replace it offers to make a new Draft, update your current Draft, or do nothing.

This action group is set up as a keyboard group, which should make quick entry easier. You can get the action group from the Draft 5 Action Directory: OF Taskpaper

omnifocus drafts

Related Posts



This post finally caused me to jump ship on 2Do and join the OF family. This is a huge help! Is there a way to add notes to the project/task/subtasks? I use a lot of checklists for video production etc, and having notes with urls to references in Google Docs would be a huge help! Either way thanks!
Tue, 25 Sep 2018 11:48:36
Is anyone else having an issue with cursor placement or is it just me? I’m using Omni 3 and Drafts 5. When I select the due / defer quick action, it populates the @Due but places the cursor in the incorrect position, so then I must adjust it to be back in between the (). Anyone else seeing this? Rose is this something you’re aware of?
Mon, 04 Jun 2018 14:15:33
Stephen Adams
Please can you direct me to where I can learn to apply this. I’m using drafts 5 and omnifocus 3 beta.
Tue, 24 Apr 2018 21:44:58
Chris Edwards
Thanks Rose! When I use this is takes the due() argument and adds it to the test rather than treating it as the due date. Any idea what I might be doing wrong?
Sun, 22 Apr 2018 01:37:15

Add a comment

Previous Post Next Post