---
title: "Editor overview"
url: "/help/buuk/editor-overview"
updated: "2026-11-13T16:22:19.689Z"
---
# Editor overview

Every article is a list of blocks. Paragraphs, headings, code, callouts, and tables are separate blocks you insert as you write.

![The editor: the Pages tree on the left, the toolbar with Preview in help center, Refresh with AI, and Publish, and the article body.](/api/media/assets/bd1cca9f-0938-4c9a-9a6e-e726616768c1)

Press `/` on a new line to open the insert menu, then type to filter it. The menu matches block names, hints, and keywords, so searching `faq` finds the accordion and searching `ul` finds the bulleted list.

## The insert menu

**Text** — headings and paragraphs:

- **Title** — large section heading (h1)
- **Subtitle** — medium section heading (h2)
- **Heading** — small section heading (h3)
- **Text** — plain paragraph

**Lists** — three kinds of list:

- **Bulleted list** — simple dot list
- **Numbered list** — ordered steps or ranked items
- **To-do list** — checkboxes for task tracking

**Media** — images, video, and embeds:

- **Image** — uploaded and compressed for you
- **Video** — uploaded and optimized for you
- **Embed** — a YouTube or Loom URL
- **Custom embed** — paste HTML from Typeform, Cal, Supademo, and other widget providers

**Callouts & blocks** — everything that wraps content:

- **Note**, **Tip**, **Warning**, and **Danger** callouts
- **Steps** — a numbered procedure with a title on each step
- **Accordion** — an expandable section
- **Code block** — one snippet with syntax highlighting
- **Code tabs** — several snippets grouped by language
- **Card** — a highlighted content block
- **Columns** — two side-by-side columns
- **Quote** — a blockquote
- **Divider** — a horizontal rule
- **Table** — starts as a 3×3 grid with a header row
- **Reusable block** — insert a saved snippet from your content blocks

## Markdown shortcuts

If you type faster than you click, most block starts have a markdown shorthand. Type the trigger and a space:

| Shortcut | Result |
| --- | --- |
| # | Title (h1) |
| ## | Subtitle (h2) |
| ### | Heading (h3) |
| - | Bulleted list |
| 1. | Numbered list |
| > | Quote |
| --- | Divider |
| ```js | Code block in JavaScript — replace js with any language id, or leave it out for the default |

Inline formatting stays as usual: `**bold**`, `*italic*`, and ``code``.

## Keyboard shortcuts in nested blocks

Some blocks trap the cursor on purpose — code blocks, callouts, steps, quotes, and tables. Press `⌘↵` (or Ctrl+Enter) to step out and start a new paragraph. `Esc` does the same. Inside a code block, `Tab` inserts a tab character instead of moving focus. In tables, `Tab` moves to the next cell.

## Autosave and versions

Saving is automatic — there is no save button and no dialog. Work keeps going while you type. Version history keeps earlier snapshots, so a bad edit never loses the good draft.

> [!WARNING]
> Autosave saves the draft, not the live page. Customers see nothing until you publish — see [Write and publish an article](./write-and-publish-an-article).

## Per-block guides

Each insertable block has its own page:

- [Callouts](./callouts)
- [Steps](./steps)
- [Accordions](./accordions)
- [Cards and columns](./cards-and-columns)
- [Code blocks and code tabs](./code-blocks-and-code-tabs)
- [Tables](./tables)
- [Images and lightbox](./images-and-lightbox)
- [Videos](./videos)
- [Embeds](./embeds)
- [Reusable content blocks](./reusable-content-blocks)
- [Media library](./media-library)

## Related

- [Editor blocks](./editor-blocks)
- [Write and publish an article](./write-and-publish-an-article)
- [Organize sections and folders](./organize-sections-and-folders)
- [Images and screenshots](./images-and-screenshots)