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.

GroupWhat's in it
StyleText, Heading 1–3, bullet list, numbered list, to-do list, blockquote, code block
InsertEmoji, table, separator, callout, button, toggle, table of contents, YouTube
UploadImage, 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.

Keep reading