docs-builder
Loading

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.

Note

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.

Warning

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.

Tip

This is a tip.

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

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

Important

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.

This is my callout

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.

Note Stack 9.1.0

This note applies to the Elastic Stack GA version 9.1.0.

Warning Serverless

This warning applies to serverless GA.

Tip ECH ECE

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.
:::