Pages can use far more than basic formatting. The editor shows most of it as you'd expect. A few kinds of content can only be drawn by your live site, so the editor keeps them exactly as written in a labelled box, called a raw block, or a small inline chip.
What shows as written
| In the editor | Content | Example |
|---|---|---|
| Maths block | A KaTeX equation | $$ E = mc^2 $$ |
| Container | Tabs and other ::: blocks |
:::tabs … ::: |
| Component | A Blade-style component | <x-callout type="tip">…</x-callout> |
| Macro | A ready-made block | @docs('button', text: 'Start', href: '/start') |
| Footnote | A footnote's text | [^1]: The note. |
| HTML | Raw HTML | <details>…</details> |
These appear inline as chips:
| Chip | Content | Example |
|---|---|---|
| Inline maths | An equation in a sentence | $x^2$ |
| Footnote reference | A link to a footnote | [^1] |
| Icon | An icon | @icon('star') |
| Variable | A value filled in by your site | {{ version }} |
| Macro | A macro in a sentence | @docs('badge', text: 'Beta') |
Edit the text inside a block or chip to change it. Your live site renders it properly; the editor never changes it.
The Insert menu and the slash menu add each of these with a working example to start from. See Writing and formatting.
Removing a block or chip
- Hover over a raw block and click its × button.
- Or, in a block or chip, clear its text and press Backspace or Delete.
- Or press Backspace at the very start of a block, or Esc, to select it, then press Backspace again.
From the line after a block, Backspace at the start selects the block; press it again to remove it.
Diagrams
Add a diagram with Insert → Diagram, or set a code block's language to
mermaid. Write Mermaid syntax and it renders as a
diagram on your live site:
graph LR Write --> Publish --> Live
Tabs
Insert → Tabs adds switchable panels. Each --- line starts a new tab:
:::tabs
--- macOS
Install with Homebrew.
--- Windows
Install with winget.
:::
For code examples in several languages, use Insert → Code tabs instead, or give consecutive code blocks a tab label.