Callouts
New (v0.4.0)
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
The following examples were generated with this configuration:
callouts:
highlight:
color: yellow
important:
title: Important
color: blue
new:
title: New
color: green
note:
title: Note
color: purple
warning:
title: Warning
color: red
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
You can put the callout markup either before or after its content. ↩