Documents and the editor

#The block menu with /

At the start of a line or after a space, / opens the block menu right at the cursor. Keep typing to filter: /h2, /todo, /code, /tab. Arrow keys choose, Enter or Tab inserts, Esc closes.

#Voice notes

/voice opens the recorder: tap the microphone, speak, Stop recording (at most ten minutes). You can listen to the recording or discard it; Insert puts it into the page as audio. If speech recognition is set up, the spoken words follow below as text; otherwise the dialog only offers the audio.

#Focus mode

Focus mode (quick search → > focus) hides the sidebar, toolbar and page margins; the top bar only appears on hover. At the bottom, a bar counts the words of the page and those added in this session. With a goal (e.g. 500 words) a bar shows the progress; the device remembers the goal per page. Esc ends the mode.

#Synced blocks

A synced block (/sync → Synced block) is content that is the same in several places – such as contact details, a checklist or a status notice. Insert synced block shows it on another page. You can edit it everywhere; the change appears on all pages, live on pages that are open.

• An orange frame marks the block; at the top it shows the number of pages and the page it was created on.
• The trash icon in the frame removes the block only in this place; it stays in the others.
• Permissions come from the page the block was created on: whoever may not read that page sees a notice instead of the content.
• The search finds the text on the original page. The block does not appear on published pages.

#Tasks with assignee and date

A task (/todo or [] + space) with a mention such as @Anna is assigned to Anna: she gets a notification and finds the task under My tasks in the sidebar. You set a date while the cursor is in the task, with the calendar button in the toolbar or through the text menu (select text or right-click → Due date). The date appears as a chip at the right of the line (highlighted today, red when overdue); a click on it changes the date or removes it with Remove date. A new task made with Enter starts without a date.

My tasks collects all tasks given to you, your own tasks with a date and all tasks from your journals (even without @name and without a date) – grouped into Overdue, Today, Next 7 days, Later and No date. Below, From other workspaces lists your tasks from your other workspaces, per workspace; clicking the page switches there. Ticking off and changing the date take effect right in the document, also for others who have it open. On the due date a reminder arrives in the morning; the number next to "My tasks" shows how many are due today or overdue.

#Markdown shortcuts

While you type, the editor converts:

#Format text

Selecting text – or right-clicking it – opens the text menu: reactions for the paragraph, bold, italic, underline, strikethrough, highlight, code, link, Comment and Copy, in tasks also Due date. The toolbar above the text adds headings, colour and background colour, superscript and subscript, inline formulas and Hide (spoiler).

• Formatting only applies to the current line. After Enter the new line starts as normal text – only lists and tasks continue with a new item, and a heading is followed by a paragraph.

#Spoiler

Hidden text stays hidden while you write. A click on the area reveals it, another one hides it again. ⌘ ⌥ H hides the selection. Sticky notes and text on whiteboards can be hidden too.

#Indent

• Tab at the start of a paragraph or heading indents it (up to eight levels), ⇧ Tab outdents it.
• Backspace at the start of an indented line first removes one level.
• In lists Tab nests the item below the previous one; in code blocks it inserts two spaces.

#Move blocks

A handle (⋮⋮) appears to the left of every block on hover. Dragging shows an insertion line in the middle of the gap between two blocks; when you let go, the block glides to its new place. A click on the handle opens Manage blocks: move – also into callouts or columns –, duplicate or delete, one block or several neighbouring ones.

List items and tasks stay what they are when moved: outside their list they form a list of the same kind of their own, and a numbered item keeps its number. Right next to a matching list they become part of it; in another kind of list they adapt.

⌘ ⇧ ↑/↓ moves the current block past its neighbour. Every block action can be undone on its own.

#Images, files and embeds

• Pasting from the clipboard (⌘ V) or dragging in uploads images and files. Images can be resized at their edges.
• Photos are scaled down before uploading: at most 2560 px on the longer side, stored as WebP. The camera rotation is kept, metadata such as the location is removed. GIFs, SVGs and files that would hardly get smaller stay unchanged. Attachments in file properties and forms are stored as they are.
• PDFs appear as a card with a preview of the first page. A click opens the PDF viewer with all pages, zoom (also ⌘ +/−) and Download; Esc closes it. The same applies to PDFs in the media library, in files properties of databases and on published pages. In editable text, ⌘-click a link to a PDF to open the viewer.
• Media in the sidebar collects all uploads of the workspace for reuse.
• Embed (/embed) takes an address: YouTube, Vimeo, Loom, Spotify, Figma and CodePen appear as players with an adjustable width, other sites as a link card with title and preview image.
• Links to pages and mentions of people show a preview on hover.
• The administrators set the maximum file size (10 MB by default).

#Formulas, diagrams and code

• Formulas in LaTeX: as a block with /math, inside the text with /inlinemath. The preview appears while you type.
• Mermaid diagrams: a click or Enter opens the source and preview. Up to 20,000 characters and 500 edges.
• Code blocks: choose the language in the header; Wrap lines and Copy are at hand. Tab indents by two spaces.

#Page links and mentions

@ searches pages and people. Mentioning a person notifies them in the inbox. Links to pages stay valid even if the page is renamed or moved; the target page lists them under Linked from.

#More blocks

• Table of contents: lists the headings of the page and jumps there on click.
• Two columns: blocks side by side; stacked on a phone.
• Linked database: a view of an existing database with its own filters and sorting; changes to records go to the source. See Views.
• Whiteboard: a whiteboard right in the document; the button at the top right opens it large.