Documents
A document is a multi-page rich-text editor that lives as a card on your canvas. It has a page tree, a full formatting toolbar, tables, images, code blocks and embedded boards, real-time co-editing with visible cursors, inline comments, and find and replace. Open it full screen or docked beside the canvas.
A document is where the writing goes. It lives as a card on a canvas, so a treatment sits beside the references it came from rather than in a different application.
Add one with the doc tool in the rail.
Opening
Two modes:
- Full screen — the document fills the window
- Side — docked beside the canvas, resizable, so you can write while looking at the board
Double-clicking a document card opens it in whichever mode you used last, so if you work docked you stay docked. The dock and full screen swap either way from the buttons in the document's header.
A docked document is held by the workspace, not by the canvas underneath it. You can open other clusters, drill into nested ones, and move around the sidebar with the document still open beside you — it stays put until you close it. One document is docked at a time; opening another hands it the pane. Docking a document also takes over the split view pane, since there is only one.
The three panes
Pages on the left — a hierarchical tree. Documents are genuinely multi-page, and pages nest. A new page is created automatically when the current one fills up, so long-form writing does not stop to manage pagination.
The body in the middle, with the formatting toolbar above it.
Bookmarks on the right — durable anchors into specific places in the text, which survive editing around them.
Zoom runs from 25% to 200%.
Writing and formatting
The toolbar carries the usual: headings, bold, italic, underline, highlight, lists, task lists, alignment, colour, font and size. Every one has a keyboard shortcut.
⌘F opens find and replace.
The footer shows a live word and character count, and an honest save status — it reports what has actually been persisted rather than an optimistic tick.
Insert
The Insert menu adds:
- Image
- Table
- Divider
- Code block
- Embed board — a whole cluster, rendered inside the document
Blocks can be reordered by dragging the handle in the left margin.
Working together
Documents are collaborative in real time, with peer cursors and selections visible as people type. Edits merge rather than overwriting.
Undo
Two histories, matching how documents are edited:
- Typing:
⌘Zwhile the caret is in the text undoes your writing, as in any editor. - Structure:
⌘Zwith the document open but the caret elsewhere undoes page operations — deletes, moves, renames. Deleting a page with its sub-pages, comments and bookmarks is one step, and page deletes also offer an undo toast.
Both undo only your edits, never a collaborator's.
Comments, tags and links
The margins do a lot of work:
- Inline comments on a text range, with dots in the right margin
- Tag ranges underlining text, with dots in the left margin
- Suggested entities — names the app noticed, with a tick or a cross in the margin to confirm or dismiss
- Links and mentions —
@anything, with hover previews - Backlinks — everywhere this document is referenced from
Screenplays
Documents have a dedicated screenplay mode with industry-standard formatting, correct pagination, a scene navigator, a title page, and Final Draft and Fountain import and export.
Exporting
PDF, Markdown, HTML, and for screenplays .fdx and .fountain. See Exporting documents.
Documents versus notes
| Note | Document | |
|---|---|---|
| Lives | On the canvas | As a card, opens full screen or docked |
| Length | A paragraph or a list | Pages |
| Structure | None | Page tree, bookmarks |
| Comments | On the card | On a text range |
| Export | With the board | Its own formats |
If you find yourself scrolling inside a note, you wanted a document.
Frequently asked questions
When should I use a document instead of a note?
A note is for a caption or a short list on the canvas. A document is for anything with structure — a treatment, a brief, a script. If you want pages, use a document.
Can two people write in the same document?
Yes, with visible cursors and selections. Edits merge; there is no locking.
Can a document contain a board?
Yes. Insert a board embed and the cluster renders inside the document.
Machine-readable: /docs/documents.md · /llms.txt
What changed and when: /changelog