Dark mode
Callouts, toggles, tables, code blocks, HTML blocks

Callouts, toggles, tables, code blocks, HTML blocks

Beyond plain text, the editor ships structured blocks for notes, collapsible sections, tabular data, code, and even raw HTML — each with sensible defaults and safe rendering.

Callouts

Five variants, each with its own color and icon: Info, Warning, Tip, Danger, Success. Change a callout's variant from its toolbar. Callouts are the right way to flag caveats and prerequisites — they survive markdown export and render on the public help center.

Toggles

A Toggle is a collapsible section with a title. Click the arrow to expand/collapse; whether it's open or closed is saved with the document. Use toggles for FAQ answers, advanced configuration, and appendices.

Tables

  • Insert a 2×2 table with a header row, or paste CSV/TSV to create one automatically.

  • Resizable columns — drag the column edge.

  • Header-row styling, cell selection, and row/column add/delete from the table controls that appear on focus.

  • Tables export cleanly to Markdown and render on the public help center.

Code blocks

Fenced code blocks with syntax highlighting and language labeling — plus two special languages, Mermaid and nwdiag, that render as live diagrams instead of code (see Diagrams in docs). The placeholder stays empty for a clean editing canvas. Copy buttons and language selection appear on hover.

Diagrams

Diagram blocks are code blocks with a special language, so they stay addressable, commentable, and diffable like any other block. Mermaid renders flowcharts and sequence diagrams; nwdiag renders network topology. Both render on the public help center. Everything else — syntax, the Diagram/Source toggle, and how the code-based options compare with Excalidraw — lives on the Diagrams in docs page.

  • There is no /mermaid slash command — insert a Code block and switch its language to Mermaid or nwdiag.

  • Mermaid (flowcharts, sequence diagrams) and nwdiag (network topology) both render on the public help center.

  • Syntax, the Diagram/Source toggle, and the Mermaid / nwdiag / Excalidraw choice: see Diagrams in docs.

  • For freehand whiteboarding instead, use the Excalidraw block.

HTML blocks

For content the structured blocks can't express, the HTML block takes custom markup. It's safe by default:

  • Markup is sanitized before it's displayed and before export.

  • Allowed: structural tags (div/section/article…), text, lists, headings, tables, links, and images, with a limited set of attributes.

  • Styling is limited to a safe set of CSS properties (layout, spacing, color, typography) — scripts, event handlers, iframes, and dangerous styles are stripped.

  • The block shows a preview while you edit the markup, so mistakes surface immediately.

When to use what

Need

Use

Highlight a caveat

Callout

Hide optional detail

Toggle

Structured data

Table (or paste CSV)

Code sample

Code block

Diagram

Code block with a Mermaid or nwdiag language

Bespoke layout/branding

HTML block (sanitized)

Was this article helpful?