Skip to content

Your first task

Press N, or use the quick-add row at the top of the Table view: type a title, press Enter.

This is the bit that surprises people. A task in Pellet isn’t a row in a database — it’s a markdown file, exactly like a note, with some extra information at the top:

---
title: Send the quarterly report
status: doing
due: 2026-08-04
priority: high
tags: [work/finance]
---
Waiting on the numbers from Priya before this can go out.

Which means a task can have a body. Notes, links, a checklist, a pasted email — anything you’d put in a note. Most task apps give you a title and a cramped notes field; here it’s a whole document.

Field What it’s for
Status Open, In Progress, Complete or Skip
Priority None, Low, Medium or High
Due When it must be finished
Start date When you plan to start — often more useful than the deadline
Group / project A project or area, for grouping in views
Board Which board this card belongs on, if any
Type Task or meeting
Tags The same tags your notes use
Recurring See Repeating tasks

You don’t have to fill any of them in. A title alone is a valid task.

The new task dialog showing Title, Description, Status, Priority, Type, quick date buttons, start and due dates, group, tags, board and a Repeat checkbox.
Everything a task can carry. None of it is required.

Worth getting straight early. Due is the deadline. Start date is when you intend to work on it. A report due Friday that you plan to write Wednesday has both, and they do different jobs — the calendar shows you Wednesday, the overdue list warns you about Friday.

If something stops being a task, convert it. Pellet strips the task fields and leaves everything else exactly as it was — the body, your other frontmatter keys, the lot.