The Spec Editor
The spec editor is a block-based rich text editor. It supports everything you need to write clear, structured requirements — and nothing that gets in the way.
Basic formatting
Section titled “Basic formatting”| Format | Shortcut / Trigger |
|---|---|
| Heading 1 | # at the start of a line |
| Heading 2 | ## at the start of a line |
| Heading 3 | ### at the start of a line |
| Bold | **text** or Ctrl/Cmd + B |
| Italic | *text* or Ctrl/Cmd + I |
| Inline code | `code` |
| Bullet list | - or * at the start of a line |
| Numbered list | 1. at the start of a line |
| Blockquote | > at the start of a line |
| Horizontal rule | --- on its own line |
Block menu
Section titled “Block menu”Type / anywhere in the editor to open the block insertion menu. From here you can insert:
- Tables
- Code blocks
- Requirement cards (all configured card types)
- File attachments
Tables
Section titled “Tables”Tables are useful for decision matrices, data field definitions, or side-by-side comparisons. Insert a table via the / menu. Click any cell to edit; use Tab to move between cells and add new rows.
File attachments
Section titled “File attachments”Files can be attached directly to a spec page. Type / and select File to upload a document, image, or any other attachment. The file is stored with the page and accessible to all project members.
Mentions
Section titled “Mentions”Type @ followed by a team member’s name to mention them. This sends them a notification with a direct link to the spot in the document where they were mentioned. Mentions work for both Providers and Clients.
Page title
Section titled “Page title”The page title sits at the top of the editor. Click it to rename the page. The new name is reflected immediately in the sidebar.
Autosave
Section titled “Autosave”The editor autosaves continuously. There is no save button and no risk of losing work by closing the tab.