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:
A relevant piece of information with no serious repercussions if ignored.
This is a note. It can span multiple lines and supports inline formatting.
:::{note}
This is a note.
It can span multiple lines and supports inline formatting.
:::
You could permanently lose data or leak sensitive information.
This is a warning.
:::{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.
This is a tip.
:::{tip}
This is a tip.
:::
Ignoring this information could impact performance or the stability of your system.
This is an important notice.
:::{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.
It can span multiple lines and supports inline formatting.
:::{admonition} This is my callout
It can *span* multiple lines and supports inline formatting.
:::
Admonitions support the applies_to
property to indicate which products or versions the information applies to.
This note applies to the Elastic Stack GA version 9.1.0.
This warning applies to serverless GA.
This tip applies to ECH and ECE.
:::{note}
:applies_to: stack: ga 9.1.0
This note applies to the Elastic Stack GA version 9.1.0.
:::
:::{warning}
:applies_to: serverless: ga
This warning applies to serverless GA.
:::
:::{tip}
:applies_to: { ess:, ece: }
This tip applies to ECH and ECE.
:::