Create a page
- Open Docs in the sidebar.
- Hover over a space and press + (Add to this space).
- Choose New page. If New page is the only thing you can create there, + creates the page right away.
Write in a page
An empty line shows Type ’/’ for commands. Type / to open the block menu, then type to filter it. The menu is split into sections: Basic blocks, Media, Databases, Advanced blocks, Inline and Embeds. Blocks you’ll use most:- Text: Text, Heading 1, Heading 2, Heading 3, Heading 4
- Lists: Bulleted list, Numbered list, To-do list, Toggle list
- Others: Quote, Callout, Code, Divider, Table, Block equation
- Files and links: Image, Video, File, Web bookmark, Embed
- Pages and data: Page, Link to page, Mention a person, Table view
Markdown shortcuts
At the start of a line, type one of these and a space:
Type
``` for a code block and --- for a divider.
Mentions
Type @ to mention something. The list is grouped into People, Link to page, Sessions and Date. Add new sub-page at the end of the list creates a new page inside this page and links to it. Once you’ve typed a word after @, it shows under New page as New “…” sub-page. It’s there for people who can edit the page.Images and files
Choose Image or File in the / menu. You can also paste files or drag them onto the page.Tables
Choose Table in the / menu. The + buttons on the right and bottom edges of a table add a column or a row. Click the bar on a row or column to open its menu: Insert above, Insert below, Duplicate, Clear contents and Delete. Table view adds a database inside the page. See Databases.Sub-pages
A sub-page is a page inside another page. Create one in either way:- Type / and choose Page.
- Type @ and choose Add new sub-page.
Page icon and cover
Above the title, people who can edit see Add icon and Add cover.- Click the icon to change or remove it.
- Add cover adds a color cover. On the cover, Change cover lets you pick from Gallery, Upload or Link. Reposition moves the image, and Remove takes the cover off.
Comments
- On the whole page: press Add comment above the title (shown until the page has its first page comment), or choose Comment in the page’s menu in a database.
- On some text: select it and press Comment in the toolbar that appears. People who can only comment can do this too.
Page options
The ⋯ button (Page options) at the top right of a page has:- Start session
- Copy link, Copy page content, Duplicate, Move to, Archive, Move to trash
- Small text, Full width, Lock page
- Undo, Export as PDF, Version history
- Get notified, Open in
Version history
Version history lists earlier versions of the page. Pick one and press Restore. The current state is kept as a version, so you can undo it. Properties are not restored.Share a page
Press Share at the top of the page. If you have Full access, the panel has two tabs: Share and Publish. Others see only who has access. With Full access, in Share:- Add people by name or email. Someone outside the team joins as a guest and only sees what you share.
- Under General access, choose who can open the page: Only people invited or Everyone at …. Anyone on the web with the link takes you to Publish.
- Set each person’s access level.
A sub-page follows the access of the page above it until you change it; while it follows, the panel shows Inherited from …. After you change it, Restore settings makes it follow again.
At the bottom of the panel, Copy link copies the page’s link and Send to channel… posts it in a channel.
Publish to the web
People with Full access can publish a page. Anyone with the public link can view it without signing in.- Press Share and open the Publish tab.
- Press Publish.
- Use Copy link to copy the link, or View on web to open it.
Trash and restore
Move to trash moves a page to the trash. If it has sub-pages, they go with it, and you’re asked to confirm first. The Moved to Trash message that follows has Restore to undo it right away. To get a page back:- Click Trash at the bottom of the sidebar.
- Find the page in the Trash tab.
- Press Restore. Delete from Trash deletes it for good.