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.
markdownThe 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
- Organize your notes with Tags & properties.
- Arrange ideas spatially on the Canvas.