Plain paragraphs carry most articles, but a few block types do jobs that prose cannot: a callout that a reader will not scroll past, a code sample they can copy, a table that lines options up. Every block below is inserted from the slash menu (type / on an empty line) and moved with the block handle.
| Block | What it is for | Options |
|---|---|---|
| Callout | A note, tip, or warning aimed at the reader | Colour and icon |
| Code | A code sample or terminal command | Language picker, copy button for readers |
| Table | Comparing options, listing fields, plan limits | Starts at 3×3 with a header row; resizable columns |
| Feature card | Spotlighting one feature partway through an article | Icon, eyebrow label, title, body text, optional screenshot |
| Embed | A short video walkthrough | YouTube, Vimeo, or Loom URL |
| Divider | A visual break between sections | None |
Callouts
A callout is an accent-bordered panel with a leading icon. Pick a colour and an icon from the block's toolbar to match the tone of what you are flagging: a calm colour for a note, a warmer one for a warning. Everything inside is normal rich text, so bold, links, and inline code all work. Keep to one or two per article; a page of callouts has no emphasis left.
Code blocks
Code blocks are syntax-highlighted across 24 languages. Choose the language from the picker on the block, and readers get a one-click Copy button on the published page. Use a code block for anything longer than a single command; for a file name or flag named mid-sentence, use inline code instead (see Format text: headings, inline marks, links, lists & quotes).
Tables
A new table starts at three columns by three rows with a header row. Drag a column boundary to resize it. Tables work best for information a reader compares across rows; for a sequence of actions, a numbered list is easier to follow.
Feature cards
A feature card is a branded visual block with an icon, an eyebrow label, a title, body text, and an optional screenshot. Use it to spotlight a specific feature partway through a longer article, where a heading and paragraph would not stand out enough.
Embeds
Paste a YouTube, Vimeo, or Loom link into the Embed block and it renders as a playable video. Other video providers and arbitrary iframes are not supported; link to them instead.
Dividers
A divider is a horizontal rule. Use it to separate sections that are not worth a heading of their own.