What's new in TaskPaper 3?

Important This post was created to inform TaskPaper 2 users of what’s new in TaskPaper 3. To learn about TaskPaper 3 changes please see the release notes.

Everything and nothing!

TaskPaper is a modern rewrite of TaskPaper 2, all the code is new and there are new features in the app. With that said the core TaskPaper experience is the same. There are no new features in the underlying file format. TaskPaper is still just plain text formatted lists of projects, tasks, notes, and tags.

There are some of the new editor features:

  1. Folding items – You can now fold items, hiding the items indented under them. To fold and item click the blue bullet point to the left of the items text.

  2. Focus projects – You can now truly focus projects instead of just filtering to show a single project. The difference is when you focus a project like this you’ll no longer see all the leading indentation. This means you can create deep levels of subprojects and still edit them comfortably, instead of seeing a bunch of leading whitespace everywhere.

  3. Outline level guides – TaskPaper now reenforces the underlying outline structure by drawing guides down from each item that contains other items.

  4. Tabs are no longer used in editor – Tabs are still part of the underlying file format. But when you open your file in TaskPaper tabs selectable characters in the editor. This puts the focus more on items and indentation without having to muck through tabs.

  5. Search syntax – TaskPaper’s search syntax has been updated to better search item hierarchies. Basic tag and boolean searches are still the same, but there are a lot more options now … documentation on the way! If you’ve used FoldingText TaskPaper searches are very similar.

  6. Date/Time syntax – TaskPaper now has a standard syntax for dealing with dates and times and relative dates and times. For example you can now search for items that are due “next week”.

  7. LESS/CSS Powered Themes – TaskPaper now uses LESS/CSS syntax for creating themes. The style properties and elements are different then HTML DOM (more limited), but generally TaskPaper styling should be much more approachable and familiar to people who already know LESS/CSS.

  8. JavaScript Scripting API – TaskPaper 3 has an OS X native user interface, but behind the scenes the outline model is implemented in JavaScript. Your scripts have direct access to TaskPaper’s underlying outline model. Here’s how to get started scripting TaskPaper.