Callouts

Callouts let you set important information apart from the rest of a document without breaking the reading flow. A tip, a warning, an open question, a worked example, each gets its own colored, labeled box so a reader can scan a page and immediately spot what needs their attention, instead of hunting for it inside a wall of paragraphs.

Creating a callout

Add [!type] to the first line of a blockquote, where type is one of the supported callout types. Every line below it that starts with > becomes the body of the callout, and the body supports the same Markdown you use everywhere else in the document, including links and headings.

> [!tip] Here's a callout title
> Here's a callout body. It supports **Markdown** and [links](/help/editor/markdown).

You don't need to remember the syntax to add one. Open Insert from the context menu and choose Callout to drop in a default callout with the cursor already placed on the title. To wrap content you've already written, a paragraph, a list, even a code block, select it first and run the same Insert, then Callout action; the selection is enclosed automatically. Once a callout exists, right-click its title to change its type without retyping anything.

Changing the title

A callout's title defaults to its type name. Add your own text right after the type identifier to override it, or leave the body empty entirely to create a title-only callout, useful for short labels that don't need supporting text.

> [!warning] Don't skip this step
> Deleting a project removes it for every collaborator.

> [!todo] Follow up with design

Foldable callouts

Add a + or - directly after the type identifier to make a callout collapsible. A + starts it open, and a - starts it collapsed. Either way, a toggle appears in the corner of the callout so a reader can fold or unfold the body on their own, which is handy for long asides, spoilers, or answers you want a reader to attempt before revealing.

> [!faq]- Are callouts foldable?
> Yes. In a foldable callout, the body is hidden until it's expanded.

Nested callouts

Callouts can be nested inside one another by adding an extra > for each level, which is useful for grouping a question with its answer, or an example with a caveat.

> [!question] Can callouts be nested?
> > [!todo] Yes, they can.
> > > [!example] You can even stack multiple levels.

Callout types

Every type below renders with its own accent color and heading color. Types listed together share a color, so pick whichever name reads best in context, tip and hint, for example, look identical.

Type names are case-insensitive, and any type Zelares doesn't recognize falls back to the default note styling, so a typo in a type identifier won't break the callout, it will just lose its custom color.

Context menu support

• Use Insert, then Callout to add a note callout.
• Select text first to wrap the selected lines in a callout.
• Right-click inside a callout to edit it, change its type, or remove the callout wrapper.

Related pages

Callouts are built on top of the editor's standard Blockquotes. For the full range of insert and formatting actions, see Context Menu. For a full overview of supported Markdown formatting, see Syntax.