Dokly is a block editor. Every chunk of content — a paragraph, a heading, a callout, a code block — is a block you insert, configure, and rearrange visually. There's no syntax to memorize.
The block model#
Every chunk of content in the editor is a block:
- A paragraph is a block.
- A heading is a block.
- A callout is a block.
- A code block is a block.
Blocks have:
- A drag handle that appears on hover (left of the block).
- A
+button to insert a new block above or below. - Settings specific to that block type (e.g., callout color, code language) — opened from the block's inline controls or the inspector panel.
You can move blocks by dragging the handle, delete by selecting and pressing backspace at the start of the block, and duplicate with ⌘D.
Screenshot needed
short screen recording or annotated screenshot showing drag-and-drop block reordering
Inserting blocks#
There are three ways to insert a block — pick whichever feels fastest in the moment.
Slash menu#
Type / anywhere to open the block picker. Filter by typing — /cal jumps to Callout, /code jumps to Code Block, /api jumps to API Playground.
The slash menu is the right default. See Slash menu for the full block list.
Markdown shortcuts#
Type a Markdown shortcut and press space — the block transforms automatically.
| Type | Becomes |
|---|---|
# | Heading 1 |
## | Heading 2 |
### | Heading 3 |
> | Blockquote |
- | Bullet list |
1. | Ordered list |
- [ ] | Task list |
``` | Code block (then type the language) |
--- | Horizontal divider |
These work for fast typing. For everything else (callouts, tabs, cards, FAQs, badges, the API playground), use the slash menu.
Paste#
Paste an image and it uploads. Paste Markdown and it parses into blocks. Paste a URL on selected text and it becomes a link.
What blocks Dokly supports#
| Category | Blocks |
|---|---|
| Text | Paragraph, Heading 1/2/3, Bullet list, Ordered list, Task list, Quote, Divider |
| Code & data | Code block, Table |
| Highlights | Callout (info, warning, error, success, tip) |
| Structure | Steps, Tabs, Card, Card Group, FAQ |
| Inline | Badge |
| Media | Image |
| API docs | API Playground |
For deep dives on each, see Components → Overview.