Skip to main content Link Search Menu Expand Document (external link)

Callouts

Markdown does not include support for callouts. However, you can style text as a callout using a Markdown extension supported by kramdown: block IALs.

Common kinds of callouts include highlight, important, new, note, and warning.

These callout names are not pre-defined by the theme: you need to define your own names.

When you have configured the color and (optional) title for a callout, you can apply it to a paragraph, or to a block quote with several paragraphs, as illustrated below.1

An untitled callout

{: .highlight }
A paragraph

A paragraph

A single paragraph callout

{: .note }
A paragraph

A paragraph

{: .note-title }
> My note title
>
> A paragraph with a custom title callout

My note title

A paragraph with a custom title callout

A multi-paragraph callout

{: .important }
> A paragraph
>
> Another paragraph
>
> The last paragraph

A paragraph

Another paragraph

The last paragraph

{: .important-title }
> My important title
>
> A paragraph
>
> Another paragraph
>
> The last paragraph

My important title

A paragraph

Another paragraph

The last paragraph

An indented callout

> {: .highlight }
  A paragraph

A paragraph

Indented multi-paragraph callouts

> {: .new }
> > A paragraph
> >
> > Another paragraph
> >
> > The last paragraph

A paragraph

Another paragraph

The last paragraph

Nested callouts

{: .important }
> {: .warning }
> A paragraph

A paragraph

Opaque background

{: .important }
> {: .opaque }
> <div markdown="block">
> {: .warning }
> A paragraph
> </div>

A paragraph

  1. You can put the callout markup either before or after its content.