Skip to content

Task Board (macOS Only)#

The Task Board is FoldNotes' answer to the oldest tension in note-taking: tasks belong in their notes, where they have context — but tasks buried in notes get forgotten. The board pulls every task from every note in your collection into one kanban view, without ever moving a task out of its note. The note stays the single source of truth; the board is that truth, viewed sideways.

Open it with Shift+Cmd+B or View → Task Board. It opens in its own window, designed to sit beside your editor while you work.

Task Board — kanban columns grouped by status


Live, in both directions#

The board isn't a report you refresh — it's a working surface that mirrors your editing as it happens:

Every edit reaches the board instantly

  • Tick a checkbox or use a / command (priority, due date) in the editor — the card moves to its new column immediately.
  • Type on a task line — the card's title updates as you pause, including due: and priority: tokens typed as text, which re-file the card.
  • Edit in the task editor — due date, priority, text, comments — and the card updates the moment you commit, even when the note isn't open anywhere.
  • Undo (Cmd+Z) in the editor moves the card back.

And the reverse direction is just as direct: drag a card between status columns and the checkbox in the note changes; edits on the board write straight back into your markdown. Newly typed tasks join the board when the note saves (moments later); edits from other devices arrive with sync.

Anatomy of a card#

Card anatomy — status, pills, comments, source note

Everything on a card comes from the task's line (and the > block quotes under it) in your note:

  • Status circle — the four-state checkbox: not started [ ], in progress [/], done [x], cancelled [-]. Click it to cycle.
  • Metadata pillsdue:, priority:, and project, parsed from the task line's tokens.
  • Comments — up to two lines from the task's comment block.
  • Source note — click anywhere on the card to jump to the exact task line in the editor. Double-click (or Enter) opens the task editor for focused changes: status, due date, priority, project, and a free-form comments editor with full markdown.

Multi-select works as you'd expect: Cmd-click to toggle, Shift-click for a range — then drag or change status for all of them at once.

Grouping#

Four grouping modes, switched from the toolbar — the columns rearrange in place, keeping your scroll position on filter changes:

Mode Columns
Status (default) Not Started, In Progress, Done, Cancelled
Priority High, Medium, Low, None
Due Date Overdue, Today, Tomorrow, This Week, Later, No Date
Project One column per project, plus No Project

Column headers stay pinned while you scroll, with live task counts. Within a column, sort by due date, priority, source note, or status.

The calendar overlay#

Calendar overlay — tasks plotted by due date

Toggle the calendar to see every dated task plotted on a month grid, beside the board. Click a day to filter the board to that day's tasks; navigate months freely (it scrolls back a full 24 months and always opens on today). Dragging a due date change onto a task — from the calendar or the task editor — updates the affected day cells immediately.

Filtering#

The filter bar narrows the board by status, project, tag, or a text search — and filters compose, so "high-priority #launch tasks containing email" is one filter away.

Reminders that finish the job#

Tasks with due dates can fire notifications — and since Build 20, the notification itself can complete the loop: Mark Done ticks the task in its note directly from the reminder banner, no window needed, with two snooze options beside it. The board card moves the moment it happens.

Part of a bigger system#

  • The same tasks power the Inspector's Tasks tab (per-note view), the doc list's task circles, and database views with task rules.
  • The command line tool reads and mutates the same tasks — fn tasks --project alpha, fn tasks --due-before friday — for scripting and integrations.
  • Task syntax, metadata tokens, and comments are documented in Tasks — everything is plain markdown in your files.

macOS only

The Task Board is a macOS feature. On iPhone and iPad, task due-date notifications (with Mark Done and snooze) work identically, and saved views are the best way to track tasks across notes.