Get started

Write pages

The Pages tab: the page list, the editor and the live preview.

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 .md files 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 ![name](/assets/…). 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.

Last updated 2 November 2026