Scoria

Callouts

A callout is a block quote whose first line declares a type. Scoria renders them with Obsidian's type colors and honors their fold state.

markdown
> [!note]
> An ordinary note.

> [!warning] A title of its own
> The text after the first line is the body.

> [!tip]- Folded by default
> This content starts collapsed.

> [!info]+ Expanded by default
> This content starts open, and can be collapsed.

The syntax, precisely

The first quoted line must be [!type], optionally followed by - or + and then optionally a title:

> [!note]Not foldable
> [!note]-Foldable, starts collapsed
> [!note]+Foldable, starts expanded
> [!note] TitleThe rest of the line is the title

With no title, the type's own name is used as the title.

Three details decide whether you actually get a callout, and they are Obsidian's:

  • The type is trimmed, so > [! bad] is a callout of type bad.
  • > [!tip]Title, with no space, is not a callout — it is an ordinary block quote.
  • An id can be attached to a callout by putting ^id at the end of its header line.

The built-in types

Each has a color and an icon slot in Obsidian, and several have aliases that canonicalise to the same type:

TypeAliases
note
abstractsummary, tldr
info
todo
tiphint, important
successcheck, done
questionhelp, faq
warningcaution, attention
failurefail, missing
dangererror
bug
example
quotecite

A type Scoria does not recognize still renders as a callout, with the default appearance and the type name as its title — the same as Obsidian, and the reason a custom callout type from a theme or snippet degrades gracefully rather than vanishing.

While editing

In Live Preview, a callout's [!type] marker is folded into its title, so the callout reads as a callout while you write it. Put the cursor in the header line and the source returns.

Next

Source: sites/scoria/content/docs/format/callouts.md