Skip to content

Callouts, math & diagrams

Altretta renders three kinds of rich block inline: callouts for emphasis, KaTeX for math, and Mermaid for diagrams — each written as plain Markdown and rendered live. Nothing here needs a plugin; it's part of the editor.

Callouts

A callout is a highlighted box that draws attention to a note, tip, warning, or aside. Write a blockquote whose first line starts with [!type].

markdown
> [!note]
> Callouts are just blockquotes with a type marker.

> [!tip] Optional custom title
> Give the callout your own heading after the type.

> [!warning]
> Use these to flag anything readers shouldn't miss.

Common types include note, tip, info, and warning, each with its own icon and color. Add a title after the [!type] marker, or leave it off to use the default.

Reach for the slash menu — type / and pick a callout — to insert one without remembering the syntax.

Math with KaTeX

Altretta typesets math with KaTeX. Use single dollar signs for inline math and double dollar signs for a centered display block.

markdown
The mass–energy relation is $E = mc^2$.

$$
\int_{a}^{b} f(x)\,dx = F(b) - F(a)
$$

Inline math flows with your sentence; display math renders as its own centered equation. Full LaTeX-style notation — fractions, sums, integrals, Greek letters, matrices — is supported.

Diagrams with Mermaid

Draw diagrams from text with Mermaid: put the diagram definition in a fenced code block tagged mermaid, and Altretta renders it as a live diagram.

markdown
```mermaid
flowchart LR
  Note --> Wikilink --> Graph
  Graph --> Backlinks
```

Mermaid supports flowcharts, sequence diagrams, class and state diagrams, Gantt charts, and more — all from plain text, so your diagrams live in the same version-controlled .md file as the rest of your note and stay editable.

Because diagrams and equations are text, they're captured in your vault's signed history like everything else — you can travel back to any earlier version of a diagram and prove what it looked like at a point in time.

Next steps