Documentation

Advanced content

Maths, diagrams, tabs, footnotes, macros, components and HTML in the editor.

On this page 4

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:

markdown
:::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.