Writing a page
The editor — blocks, the slash menu, formatting, tables, images and files, and how saving works.
A page opens straight into the editor. Click the title to rename it, click into the body and start typing.
Blocks and the slash menu
Everything in a page is a block, and the fastest way to add one is to type /
on an empty line. Keep typing to filter, then press Enter.
| Group | What's in it |
|---|---|
| Style | Text, Heading 1–3, bullet list, numbered list, to-do list, blockquote, code block |
| Insert | Emoji, table, separator, callout, button, toggle, table of contents, YouTube |
| Upload | Image, audio, file |
A few worth knowing about:
- To-do list — checkboxes you can tick inside the page. Handy for a checklist that belongs to the document rather than to a task.
- Code block — syntax highlighted, with the language detected for you.
- Callout — a highlighted note for the thing people keep missing.
- Toggle — a collapsible section. Long reference pages stay skimmable when the detail is folded away.
- Button — a click counter with a label you write. Useful for a quick "who has read this" or a rough vote.
- Table of contents — a block that lists the page's headings and jumps to them.
Formatting
Select text and a toolbar appears above it:
- Bold, italic, underline, strikethrough and inline code
- Bullet, numbered and task lists
- Alignment — left, centre, right, justify
- Turn into — convert the block to text, a heading, a list or a quote
- Link
- Font (default, serif, mono), font size, text colour and highlight
- Clear formatting, when a paste has brought in too much
On a phone the same controls sit in a toolbar along the bottom of the screen, above the keyboard.
The drag handle
Hover any block and two controls appear to its left: a + that adds a block
underneath, and a handle. Drag the handle to move the block; click it for
Turn into, Duplicate and Delete.
Emoji and mentions
Type : for the emoji picker and @ for a person. A mention drops the name
into the text as a reference — it does not notify them.
Tables
Insert a table from the slash menu, and controls appear on its rows and columns as you work in it: insert above, below, left, right or at either end, delete a row or column, clear its contents, set alignment or a colour, and delete the whole table.
Images, audio and files
Three upload blocks — Image, Audio and File — all behave the same way, and you can also paste or drag a file straight into the page.
- A progress bar shows the real upload, with an X to cancel it.
- Uploads continue in the background. Navigate away mid-upload and the file still lands in the page when it finishes.
- Images render inline, audio gets a player, video plays in place, and anything else becomes a download card — PDFs with a preview.
Upload limits
The per-file size limit depends on your plan — the figures are on the pricing page.
While you write
Word and character count sit above the content, on the right, and update as you type.
A table of contents rail runs down the side of the page on a wide screen, built from your headings. Click an entry to jump to it.
Read-only pages
With View access the page opens normally — you can read it, follow links, open toggles and use the table of contents — but the slash menu, toolbars and drag handles are not there, and the title cannot be clicked. Sharing is explained in Sharing and privacy.
Frequently asked questions
I uploaded a big file and navigated away. Did it fail?
No. Uploads carry on in the background and the finished file drops into the page when it is done, even if you left and came back.
Does mentioning someone in a page notify them?
No. An @ mention in a page inserts their name as a reference — it does not send anything. Use chat or a task comment when you need someone to actually see it.
Why can't I edit a page I can open?
You have View access to it. The text, links and toggles all work, but the editing tools are hidden. Ask whoever manages that space or folder for Edit.