# Callouts

This page details how to use callouts to include additional content without breaking the flow of your notes.

Use callouts to include additional content without breaking the flow of your notes.

To create a callout, add [!info] to the first line of a blockquote, where info is the type identifier. The type identifier determines how the callout looks and feels. To see all available types, refer to Supported types. Callouts are also supported natively on Obsidian Publish.

> [!info] Here's a callout title
> Here's a callout block.
> It supports **Markdown**, [[Internal link|Wikilinks]], and [[Embed files|embeds]]!
> ![[Engelbart.jpg]]

You can insert a default [!note] callout using the Insert callout command. The cursor automatically positions in the callout name field, letting you delete the default name and type a new one before editing the content.

To wrap existing content in a callout, select the text (including lists, code blocks, etc.) and run the Insert callout command. The selected content will be automatically enclosed in the callout.

In Live Preview, you can also right-click the callout name to change the callout type.

# Change the title

By default, the title of the callout is its type identifier in title case. You can change it by adding text after the type identifier:

> [!tip] Callouts can have custom titles
> Like this one.

You can even omit the body to create title-only callouts:

> [!tip] Title-only callout

# Foldable callouts

You can make a callout foldable by adding a plus (+) or a minus (-) directly after the type identifier.

A plus sign expands the callout by default, and a minus sign collapses it instead.

> [!faq]- Are callouts foldable?
> Yes! In a foldable callout, the contents are hidden when the callout is collapsed.

# Nested callouts

You can nest callouts in multiple levels.

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

# Customize callouts

CSS snippets and Community plugins can define custom callouts, or even overwrite the default configuration.

To define a custom callout, create the following CSS block:

.callout[data-callout="custom-question-type"] {
    --callout-color: 0, 0, 0;
    --callout-icon: lucide-alert-circle;
}

The value of the data-callout attribute is the type identifier you want to use, for example [!custom-question-type].

  • --callout-color defines the background color using numbers (0–255) for red, green, and blue.
  • --callout-icon can be an icon ID from lucide.dev, or an SVG element.

# Supported types

You can use 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, such as [!tip] or [!warning]. Callout types can also be changed by right-clicking a callout in Live Preview mode.

Unless you Customize callouts, any unsupported type defaults to the note type. The type identifier is case-insensitive.


Aliases: summary, tldr




Aliases: hint, important


Aliases: check, done


Aliases: help, faq


Aliases: caution, attention


Aliases: fail, missing


Alias: error




Alias: cite