---
title: "Admonitions: tip, note, warning, see also,  etc"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:rest-admonitions"
source: "Reference/ReStructuredText/Content/Admonitions.rst"
modified: "2026-09-14T09:38:54+00:00"
---

# Admonitions: tip, note, warning, see also,  etc

The following directives are called Admonitions. You
can use them to point out additional or important
information.

## Examples

### See also

```rst
..  seealso::
    `Admonitions <http://docutils.sourceforge.net/0.7/docs/ref/rst/directives.html#admonitions>`__
```

> [!NOTE]
> **See also**
>
> [Admonitions](http://docutils.sourceforge.net/0.7/docs/ref/rst/directives.html#admonitions)

### Note

```rst
..  note::
    A note
```

> [!NOTE]
> A note

### Tip

```rst
..  tip::
    A tip
```

> [!TIP]
> A tip

You may also use the admonition **hint**, but this is very similar
and **tip** is more commonly used in the documentation.

### Warning

```rst
..  warning::
    Some text pointing out something that people should be warned about.
```

> [!WARNING]
> Some text pointing out something that people should be warned about.

You may also use the admonitions **caution** or even **danger** if the
severity of the warning must be stressed.

### Attention

```rst
..  attention::
    An attention
```

> [!WARNING]
> **Attention**
>
> An attention

## More information

The admonitions listed here are the most commonly used in the TYPO3 documentation.

For more see [reStructuredText directives in docutils documentation](http://docutils.sourceforge.net/docs/ref/rst/directives.html#specific-admonitions).