The Pages tab has three columns: the page list on the left, the editor in the middle and the live preview on the right. Use Write, Split and Preview above the editor to give the text or the preview more room.
The page list
- Sections are the headings of the sidebar. Click a section name to rename it; use the arrows to move it up or down.
- Pages move up and down inside their section with the arrows that appear on hover. To move a page to another section, change its Section field.
- + adds a page to the current section. Add a section makes a section with a first page in it.
- Drop
.mdfiles on the list to import them as pages (see Import .md files).
A green dot means published; a grey dot and the Draft label mean visitors cannot see the page yet.
The editor
| Field | What it does |
|---|---|
| Title | The page heading and its name in the sidebar and search. |
| Description | The line under the title. Search engines show it too. |
| Address | The last part of the URL, such as /acme/install. Lowercase letters, numbers and dashes. |
| Section | The sidebar section. Type a new name to start a new section. |
| Status | Published or Draft. |
The text is Markdown. The toolbar inserts headings, lists, links, tables, code blocks, callouts, steps and cards, and uploads images.
Keyboard shortcuts
| Keys | Action |
|---|---|
⌘ S / Ctrl S |
Save now |
⌘ B / Ctrl B |
Bold |
⌘ I / Ctrl I |
Italic |
⌘ K / Ctrl K |
Link |
Tab |
Indent two spaces |
Images
Press the image button, paste an image, or drop one on the text. It is uploaded (PNG, JPEG, GIF, WebP, AVIF or SVG, up to 5 MB) and inserted as . Uploaded images work on the platform and on every docs.<domain>.
Saving
Changes save about a second after you stop typing, and when you switch page or tab. If a save fails (for example because two pages would share an address), a red bar explains why; your text stays in the editor, and the next change saves again.
Warning
Closing the tab with unsaved changes asks you to confirm first. Wait for Saved before you close it.