Write and organise pages
This page shows you how to write pages with your colleagues, comment and suggest changes, keep versions, and keep a space's pages in order.
Before you start
- To write in a space, you need Can edit or Can manage in it. Where you can only read, the space says "You can read it, not edit it." Select Ask to edit at the top of the space to ask the people managing it.
- Your own space, Personal, is always yours to write in.
Write a page
- Open the space.
- Select New page. In an empty space, select Write the first page.
- Type a Title.
- Select Create page.
- Choose how to start:
- Write in the body. Press
/for blocks such as headings, lists and tables. - Choose an outline or a template under Begin with an outline.
- Type what the page is for in Draft it with AI: say what this page is for, then select Write a draft. This is shown only where AI is set up.
- Write in the body. Press
- Write. Everything is saved as you go, and colleagues on the same page see your changes and cursor as you type.
The space's More menu also has New folder, for a page that holds others, and New interactive page, for a page made of HTML.
Link pages together
- Type
[[in the body. - Choose a page from the list.
A link to a page nobody has written yet is listed on the space's page under Linked, not written yet, with a way to create it.
Comment and mention
- Select the text you want to comment on.
- Select Comment, or press Ctrl Shift M (⌘ Shift M on a Mac).
- Write the comment. Type
@to mention someone who can read the page; they are told.
A comment can be resolved when it is dealt with, and reopened later.
Suggest a change
Use this where you cannot edit, or where you want someone to look first.
- On the page, select Suggest in the editor's bar. The editor shows Suggesting.
- Make your changes. The page stays as it is until someone accepts them.
The person who made a suggestion can take it back with Withdraw.
To review a suggestion:
- Open Inbox and look under Waiting for you, or select Review on the page's Suggestions bar.
- Accept or turn down each change, or select Turn down for the whole suggestion.
Save, compare and restore versions
To mark a point you will send or come back to:
- Select Save a version.
- Type a Name (optional), such as "Sent to the client, v2", and a Note (optional) if you want.
- Select Save version. Rooms and share links offer named versions first.
To look back:
- Select History at the top of the page. It lists every version.
- To compare two versions, choose them beside Compare version and with version at the foot of the list, then select Compare.
- To go back to an older version, open its menu and select Restore. The restore is saved as a new version, so nothing is lost.
For a version that went out another way (in your own email, or in a meeting), open its menu in History and select Record as sent.
Move, rename and remove pages
- Reorder or nest pages: drag them in the sidebar's page tree, or select More actions, then Move, choose a page under Put it inside, and select Move.
- Move to another space: More actions, Move, then Move to another space.
- Rename or Duplicate: More actions.
- Remove a page: More actions, Move to trash. The space's More menu, Trash, keeps it for 30 days, where anyone who can edit the space can restore it.
More actions also has Download as Markdown and Copy link. A copied link opens the page only for people who can already read it.
Download or export
- One page as a PDF: Export to PDF at the top of the page. The PDF is saved as a file page beside it. This is shown only where the server's PDF renderer is set up.
- A whole space: the space's More menu, Download all pages, gives a zip of its pages as Markdown files, which also opens as an Obsidian vault.
Troubleshooting
"Not connected: the version can be saved once the page is back online."
Your browser has lost its live connection to the page. Your typing stays on screen; it is saved once the connection returns. If it never connects on any page, the server's web proxy is not passing live editing through: tell whoever runs the server.
"One passage clashes" and saving is paused
An AI or an import wrote to the page while you had changes that disagree with it. For each clashing passage, choose Keep mine or Take incoming. Saving starts again when every clash is resolved.
"You can read this page. The people who can edit its space can change it."
You can read the space but not edit it. Select Suggest to propose a change, or Ask to edit on the space.
Comments or suggestions are not offered
The people managing the space have limited comments or suggestions to its editors. Ask them, or ask to edit.