> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocks

> Every piece of content in the Versuno editor is a block. Insert any block with the / slash command or by typing a Markdown shortcut.

## Slash command menu

Type `/` anywhere on an empty line (or at the start of a new paragraph) to open the **slash command menu**. Start typing to filter — for example, `/code` inserts a code block, `/toggle` lists all toggle variants.

Press `↑` / `↓` to navigate, `↵` to insert, `Esc` to close.

***

## Text blocks

### Text (paragraph)

The default block. Plain prose, fully formatted.

**Shortcut:** None (default). Type on any empty line.

***

### Headings

Four heading levels, rendered with decreasing visual weight.

| Block     | Slash command | Markdown shortcut      |
| --------- | ------------- | ---------------------- |
| Heading 1 | `/heading1`   | `# ` (space after `#`) |
| Heading 2 | `/heading2`   | `## `                  |
| Heading 3 | `/heading3`   | `### `                 |
| Heading 4 | `/heading4`   | `#### `                |

***

### Code block

Monospace block with syntax highlighting. Supports multiple languages.

**Slash command:** `/code`\
**Markdown shortcut:** ` ``` ` (three backticks) on an empty line

***

### Quote

A blockquote: a visually indented block for callout prose, citations, or emphasis.

**Slash command:** `/quote`\
**Markdown shortcut:** `> ` (greater-than + space)

***

### Divider

A horizontal separator line. Useful for separating sections of a prompt or persona.

**Slash command:** `/divider`\
**Markdown shortcut:** `---` on an empty line

***

## Lists

### Bullet list

Unordered list. Supports nested items with `Tab` / `Shift-Tab`.

**Slash command:** `/bullet`\
**Markdown shortcut:** `- ` (dash + space)

***

### Numbered list

Ordered list. Numbers increment automatically.

**Slash command:** `/numbered`\
**Markdown shortcut:** `1. ` (number + dot + space)

***

### To-do list

Checklist with checkboxes you can tick directly in the editor.

**Slash command:** `/todo`\
**Markdown shortcut:** `[] ` (bracket-bracket + space)

***

## Advanced blocks

### Toggle

A collapsible section with a title and a body. Great for organising long prompts into expandable sections.

Four variants correspond to heading levels 1–4:

| Variant          | Slash command       | Markdown shortcut |
| ---------------- | ------------------- | ----------------- |
| Toggle heading 1 | `/toggle heading 1` | `# > `            |
| Toggle heading 2 | `/toggle heading 2` | `## > `           |
| Toggle heading 3 | `/toggle heading 3` | `### > `          |
| Toggle heading 4 | `/toggle heading 4` | `#### > `         |

**Using a toggle:**

* Click the **chevron** (▶) to collapse or expand the body.
* Click the **title** to edit it.
* Press `Enter` in the title to move the cursor to the first line of the body.
* Press `Backspace` at the very start of an empty title to **unwrap** the toggle — the title becomes a heading and the body blocks are placed below it.
* Press `Ctrl + D` to **duplicate** the entire toggle (title + body) immediately below.

**Indenting lists into a toggle:**

Place a bullet, numbered, or to-do list on the line immediately below a toggle. With the cursor in the **first item** of that list, press `Tab` — the whole list moves inside the toggle.

To move the list back out, press `Shift-Tab` from anywhere inside the list.

***

### Callout

A highlighted note with a coloured icon. Use it to surface warnings, tips, or key information inside an asset.

**Slash command:** `/callout`

Five tones are available:

| Tone        | Icon | Use for                             |
| ----------- | ---- | ----------------------------------- |
| **Info**    | ℹ    | General information, notes          |
| **Warning** | ⚠    | Cautions, things to watch           |
| **Success** | ✓    | Confirmations, positive outcomes    |
| **Error**   | ✗    | Mistakes to avoid, hard constraints |
| **Note**    | 📄   | Neutral side notes, clarifications  |

Click the **tone icon** on the left side of the callout to change the tone via a picker.

***

## References

Reference blocks link live content from other assets into your current asset. They appear as clickable cards and navigate to the source on click.

### Asset reference

A card that embeds a reference to another asset. Shows the asset's emoji, title, and type. Clicking the card opens the referenced asset.

**Slash command:** `/asset reference`

When inserted, a search picker appears. Type to filter your assets, then press `↵` or click to confirm. Press `Esc` to cancel and remove the placeholder.

***

### Block reference

A card that points to a specific block inside another asset. Clicking the card opens the source asset scrolled to that block.

**Slash command:** `/block reference`

Inserting a block reference opens a two-phase picker:

1. Select the source asset.
2. Select the specific block within that asset.

The card shows the block content and a note showing the asset type and block ID. Use the **back button** (or `Esc`) in phase 2 to return to the asset picker.

***

## Changing a block type

Every block has a **block type menu** accessible via the **⠿ drag handle** that appears on the left when you hover a block. Click it to open the **Turn into** submenu and select any block type. The content is preserved where possible.

You can also select text and use the **Turn into** dropdown in the [floating toolbar](/editor/formatting).