Admonitions

Admonitions allow you to highlight important information with varying levels of priority. In software documentation, these blocks are used to emphasize risks, provide helpful advice, or share relevant but non-critical details.

Admonitions can span multiple lines and support inline formatting.
Available admonition types include:

• Note
• Warning
• Tip
• Important
• Plain

A relevant piece of information with no serious repercussions if ignored.

:::{note}
This is a note.
It can span multiple lines and supports inline formatting.
:::

You could permanently lose data or leak sensitive information.

:::{warning}
This is a warning.
:::

Advice to help users make better choices when using a feature.

You could permanently lose data or leak sensitive information.

:::{tip}
This is a tip.
:::

Ignoring this information could impact performance or the stability of your system.

:::{important}
This is an important notice.
:::

A plain admonition is a callout with no further styling. Useful to create a callout that does not quite fit the mold of the stylized admonitions.

:::{admonition} This is my callout
It can *span* multiple lines and supports inline formatting.
:::

Use :open: <bool> to make an admonition collapsible.

:::{note}
:open:

Longer content can be collapsed to take less space.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
:::