AUTHORING

Callouts

Admonition blocks in Quarto syntax.

Callouts

Quarto callout blocks render as themed admonitions. Five types are supported:

Note

note — supplementary information.

Tip

tip — a helpful suggestion.

Warning

warning — something that may surprise you.

Important

important — do not skip this.

Caution

caution — potential for breakage or data loss.

::: {.callout-note}
`note` — supplementary information.
:::

Titles

Without a title, the callout is headed by its capitalized type. Set a custom one with title=:

Pro tip

Custom titles read better than bare types.

::: {.callout-tip title="Pro tip"}
Custom titles read better than bare types.
:::

Collapsible callouts

Add collapse="true" (collapsed initially) or collapse="false" (expanded, but collapsible):

Show the details

This body is hidden until expanded. Markdown inside — like code and emphasis — renders normally.

::: {.callout-note title="Show the details" collapse="true"}
This body is hidden until expanded.
:::
Limitations

Nesting a callout inside another callout is not supported yet. Callouts work in both .md and .qmd files.