The Dokly editor is where you write and structure your docs. It's a block editor with a slash menu, drag handles, and inline AI actions.
This page is a tour. The next pages cover individual features in depth.
The editor surface#
Screenshot needed
annotated screenshot of the editor showing: 1) page tree sidebar (left), 2) main editor canvas, 3) Edit/Preview tabs in the toolbar (top center)
- Page tree (left) — add, rename, reorder, and nest pages. Drag a page onto another to nest it.
- Editor canvas (center) — where you write. Each block (paragraph, heading, callout, etc.) has a drag handle on hover.
- Edit / Preview tabs (top) — switch between the editing surface and a rendered preview that matches the published site.
Three ways to insert a block#
Saving and publishing#
- Save —
⌘S/Ctrl+S. Writes to the database. The page is live on your published site within ~1 second. - Autosave — every few seconds while you type. You almost never have to think about Save.
- Draft vs published — toggle in the page settings. Drafts don't show on the live site or in the sidebar.
AI actions#
Select any text and click the sparkle button (or hit ⌘K) to run AI actions: improve, expand, summarize, translate, fix grammar. See AI actions.
For longer-form generation (a whole page from a brief, or a whole site from a description), see Generate with AI.
What gets saved#
Each page in Dokly stores:
- Title — shown in the sidebar and tab title.
- Slug — the URL path (e.g.,
editor/overview). - Description — used for the meta description and the in-app page tree subtitle.
- Content — the page body.
- Published state — draft or live.
- Order and nesting — controlled by drag-and-drop in the sidebar.
You can edit slug, title, and description from the page settings panel.