--- url: https://docs.codefox.ai/apps/library/write-and-organise-pages.md --- # 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 1. Open the space. 2. Select **New page**. In an empty space, select **Write the first page**. 3. Type a **Title**. 4. Select **Create page**. 5. 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. 6. 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 1. Type `[[` in the body. 2. 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 1. Select the text you want to comment on. 2. Select **Comment**, or press Ctrl Shift M (⌘ Shift M on a Mac). 3. 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. 1. On the page, select **Suggest** in the editor's bar. The editor shows **Suggesting**. 2. 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: 1. Open **Inbox** and look under **Waiting for you**, or select **Review** on the page's **Suggestions** bar. 2. 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: 1. Select **Save a version**. 2. Type a **Name (optional)**, such as "Sent to the client, v2", and a **Note (optional)** if you want. 3. Select **Save version**. Rooms and share links offer named versions first. To look back: 1. Select **History** at the top of the page. It lists every version. 2. To compare two versions, choose them beside **Compare version** and **with version** at the foot of the list, then select **Compare**. 3. 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.