Skip to content

Tasks#

FoldNotes has rich task support with four states, due dates, priorities, project tracking, and a kanban-style Task Board.

Task Syntax#

Tasks are lines starting with a checkbox:

- [ ] Not started
- [/] In progress
- [x] Done
- [-] Cancelled

Click a checkbox to cycle through states: Not Started → In Progress → Done → Cancelled → Not Started.

On macOS, task checkboxes are also interactive in the preview window — click a checkbox in the rendered preview and the change is applied to the source document instantly.

Task checkbox states

When a task is marked as done, FoldNotes automatically adds a done: date.

Task Metadata#

Add metadata after the task text using key:value syntax (no spaces around the colon):

- [ ] Review draft due:2026-04-15 priority:high
- [x] Send report done:2026-04-03
- [ ] Call dentist due:2026-04-10 priority:low
- [ ] Deploy feature project:alpha due:2026-04-20

You can type metadata by hand, or use the command palette to insert it — see Command Palette below.

Due Dates#

due:YYYY-MM-DD sets a due date. Tasks become overdue after 5 PM on the due date in your local timezone. Overdue tasks are highlighted in the sidebar task indicator.

Priorities#

priority:high, priority:medium, or priority:low sets the task's priority level. High-priority tasks are marked with !! in task lists.

Completion Dates#

done:YYYY-MM-DD is added automatically when you check a task. It's removed if you uncheck it.

Projects#

project:name assigns a task to a project. Projects group related tasks across notes:

  • macOS: Filter by project in the Task Board (group by Project for a column per project), the CLI (fn tasks --project alpha), or a Saved View with a "Task Project" rule
  • iOS: Create a Saved View with a "Task Project" filter rule to surface notes containing tasks from a particular project

Note

The Task Board and CLI are macOS-only. On iOS, saved views are the best way to track tasks across notes by project.

See Projects for the full project model — task-level vs note-level project tagging, the Project Browser for renaming and deleting, and how projects integrate with templates and the tag helper.

Command Palette#

The command palette is a context-aware popup that lets you quickly insert formatting and task metadata without memorising the syntax.

Trigger it by typing / at the start of a line or after a space. A floating panel appears with commands relevant to your current context:

  • On a task line — due date, done date, priority (high/medium/low), and project
  • On any other line — headings, task, bullet list, block quote, code block, and table

Command palette on a task line

Arrow keys navigate the list, Enter confirms, Esc dismisses. Typing after / filters the list to matching commands — for example, /d narrows to Due Date and Done Date.

When you select a command, FoldNotes removes the / trigger text and inserts the result. For Due Date, a date picker opens. For Priority, the metadata is inserted immediately and the palette stays open so you can chain commands (set priority, then due date, then project — all in one flow).

Platform differences#

Feature macOS iPad (keyboard) iPhone
Trigger Type / in the editor Type / in the editor Type / or tap the / button on the keyboard toolbar
Navigation Arrow keys + Return Arrow keys + Return Tap to select
Filter Type after / to filter Type after / to filter Type after / to filter
Date picker Graphical calendar popup System date picker System date picker
Project picker Floating panel with search Action sheet Action sheet

Tip

On iPhone, the command palette is especially useful for adding task metadata. Look for the / button in the keyboard toolbar — it opens the palette without having to find the slash key.

Task Comments#

Add notes to any task using block quote lines (>) directly below it:

- [ ] Review the proposal due:2026-05-15 project:website
> Check competitor pricing before the meeting
> Ask Sarah about the updated budget

- [x] Send weekly report done:2026-05-02
> Included Q2 projections as requested

Block quote lines can be indented to match the task's indentation level. Consecutive > lines are captured as a single comment block (up to 200 characters). A blank line or any non-> line ends the comment.

Where comments appear:

Platform Location How
macOS Task Board Cards show up to 2 lines of comment text below the task title
macOS CLI fn tasks includes comment text in output
iOS Editor Tap the comment indicator on a task line to see a preview

Comments are especially useful with project: metadata. Group by Project on the Task Board to see all tasks for a project with their comments visible on each card — giving you a project dashboard at a glance.

Note

Comments are stored as standard Markdown block quotes in your .md files. They sync across devices via iCloud, but the Task Board and CLI are macOS-only features. On iOS, comments are visible through the inline editor preview.

Task Indicators#

The sidebar shows a task circle next to notes that contain tasks:

  • Green arc — completed tasks
  • Blue arc — remaining active tasks
  • Red arc — overdue tasks

The label shows the count (e.g. "3/7" meaning 3 done out of 7 total).

Task Board#

The Task Board (macOS) provides a kanban-style view of tasks across your entire collection. Open it with Shift+Cmd+B or View > Task Board.

Task Board — kanban columns grouped by status

Grouping modes#

The board supports four grouping modes, selected from the toolbar:

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 a "No Project" column

Card actions#

  • Drag cards between columns to change task status (when grouping by status)
  • Click a card to jump to its location in the editor
  • Multi-select with Cmd click or Shift click for range selection
  • Cards show due date, priority, and project pills alongside the task text

Sorting#

Within each column, cards can be sorted by:

  • Due date (default)
  • Priority (highest first)
  • Source note (alphabetically)
  • Status (when not grouping by status)

Calendar overlay#

Toggle the calendar overlay to see tasks plotted on a monthly calendar, grouped by due date. Navigate between months and click a day to filter the task list.

Filtering#

Use the filter bar to narrow tasks by status, project, tag, or a text search.

Inspector Tasks Tab#

The Inspector's Tasks tab shows all tasks from the current note, grouped by status. Click a task to jump to its location in the editor. This gives you a birds-eye view of your to-do items.

Cross-Note Task Queries#

You can query tasks across your entire collection on both platforms:

macOS — CLI:

fn tasks --overdue              # All overdue tasks
fn tasks --due-today            # Tasks due today
fn tasks --priority high        # High priority tasks
fn tasks --note "Project Plan"  # Tasks in a specific note
fn tasks --status in-progress   # Filter by status
fn tasks --project alpha        # Filter by project

Both platforms — Saved Views:

Create a Saved View with task filter rules (status, priority, project, due date) to build a persistent query that appears in the sidebar. Saved views sync across devices via iCloud, so a view created on macOS is available on iOS and vice versa.

Task Notifications#

FoldNotes can send system notifications when tasks are due. See Task Notifications for details.