Skip to main content
A kanban document is a board. Columns are ## Column headings, cards are checkbox list items under them, and dragging a card in the app rewrites exactly those lines of markdown. Ask your agent for a board and it creates the document in the kanban format — see Document formats.

​
The markdown underneath

The board is stored as plain markdown you could read anywhere:
- [ ] is an open card and - [x] is done. Any indented lines beneath a card are its detail: notes and subtasks that travel with the card wherever it moves. Columns appear on the board in the order they appear in the body, and an empty column is legal — it renders as an empty column and stays in the document. The body holds nothing but columns and cards. Context and commentary about the board belong in the document’s description field, or indented under a card.

​
Working with a board in the app

The board is fully editable, and every change rewrites the underlying markdown.
  • Move cards. Drag a card between columns or to a new position within one.
  • Reorder columns. Each column has a drag handle.
  • Rename inline. Click a card title or a column title to edit it. Enter commits, Escape reverts.
  • Tick a card done. Each card has a checkbox; done cards dim.
  • Add a card. Each column has an Add card button that opens an inline composer. Pressing Enter keeps it open so you can add several in a row.
  • Delete a card. An × appears on hover. A card that carries hidden detail lines asks you to confirm first, and says that the details go with it. A bare card deletes immediately.
  • Delete a column. From the column menu. A column with cards in it asks you to confirm, and tells you how many cards it holds.
  • Read a card’s detail. Cards with detail lines show a small details pill that opens a read-only dialog.
Wikilinks written inside a card title render as clickable links.
The board has no add-column control. Columns come from the markdown, so a new column arrives when an agent writes one. There is no way to reach the raw markdown of a working board from the app.
A kanban document has no properties rail and no width control, and its title is read-only on the document page. Rename it from the sidebar.

Task trackers

The other checkbox format: sections, priorities, and dates.

Agent skills

Install the skill that teaches your agent the board grammar.