↑ Obsidian

---

Obsidian Callouts

As of v0.14.0, Obsidian supports callout blocks, sometimes called "admonitions". Callout blocks are written as a blockquote, inspired by the "alert" syntax from Microsoft Docs.

For compatibility reasons, if you're also using the Admonitions plugin, you should update it to at least v8.0.0 to avoid problems with the new callout system.

Use the following syntax to denote a callout block: > [!INFO].

> [!INFO]
> Here's a callout block.
> It supports **markdown**, [[Internal link|wikilinks]], and [[Embed files|embeds]]!
> ![[og-image.jpg]]
markdown

It will show up like this:

[!INFO] Here's a callout block. It supports markdown, [[Internal link|wikilinks]], and [[Embed files|embeds]]!

this is not a callout

Types

By default, Obsidian supports several callout types and aliases. Each type comes with a different background color and icon.

To use these default styles, replace INFO in the examples with any of these types. Any unrecognized type will default to the "note" type, unless they are customized. The type identifier is case insensitive.

[!note]
Lorem ipsum dolor sit amet
markdown

---

[!abstract]

[!abstract]
Lorem ipsum dolor sit amet
markdown

Aliases: summary, tldr

---

[!info]

[!info]
Lorem ipsum dolor sit amet
markdown

---

[!todo]

[!todo]
Lorem ipsum dolor sit amet
markdown

---

[!tip]
Lorem ipsum dolor sit amet
markdown

Aliases: hint, important

---

[!success]

[!success]
Lorem ipsum dolor sit amet
markdown

Aliases: check, done

---

[!question]

[!question]
Lorem ipsum dolor sit amet
markdown

Aliases: help, faq

---

[!warning]
Lorem ipsum dolor sit amet
markdown

Aliases: caution, attention

---

[!failure]

[!failure]
Lorem ipsum dolor sit amet
markdown

Aliases: fail, missing

---

[!danger]

[!danger]
Lorem ipsum dolor sit amet
markdown

Alias: error

---

[!bug]

[!bug]
Lorem ipsum dolor sit amet
markdown

---

[!example]

[!example]
Lorem ipsum dolor sit amet
markdown

---

[!quote]

[!quote]
Lorem ipsum dolor sit amet
markdown

Alias: cite

Title and body

You can define the title of the callout block, and you can also have a callout without body content.

> [!TIP] Callouts can have custom titles, which also supports ==markdown==!
markdown

[!TIP] Callouts can have custom titles, which also supports ==markdown==!

Folding

Additionally, you can create a folding callout by adding + (default expanded) or - (default collapsed) after the block.

> [!FAQ]- Are callouts foldable?
> Yes! In a foldable callout, the contents are hidden until it is expanded.
markdown

Will show up as:

[!FAQ]- Are callouts foldable? Yes! In a foldable callout, the contents are hidden until it is expanded.

Nesting

You can also nest callouts multiple layers deep.

> [!question] Can callouts be nested?
>
> > [!todo] Yes!, they can.
> >
> > > [!example] You can even use multiple layers of nesting.
markdown

Will result in:

[!question] Can callouts be nested?

[!todo] Yes!, they can.

[!example] You can even use multiple layers of nesting.

You can even use multiple layers of nesting.

Customizations

Snippets and plugins can define custom callouts, too, or overwrite the default options. Callout types and icons are defined in CSS, where the color is an r, g, b tuple and the icon is the icon ID from any internally supported icon (like lucide-info). Alternatively, you can specify an SVG icon as a string.

.callout[data-callout="my-callout-type"] {
--callout-color: 0, 0, 0;
--callout-icon: icon-id;
--callout-icon: '<svg>...custom svg...</svg>';
}
markdown

Developer Notes

We choose the syntax because:

• it falls back to blockquotes in unsupported markdown renderers
• it parses all Markdown, including links, embeds, etc.
• it recognizes Internal link's and will shows up in Backlinks, Outgoing links, and Graph view
• the spellchecker can spellcheck it.