# Admonitions - Hinweisboxen

> Alle farbigen Hinweisboxen im GitHub-Alert-Stil: note, tip, warning, danger und mehr - auch aufklappbar.

_Quelle: https://theme.docs.tbsch.de/de/post/2026-01-19-admonitions-hinweisboxen/ · Stand: 2026-01-19_


Hinweisboxen entstehen aus **GitHub-Style-Alerts** in ganz normalem Markdown:
ein Blockzitat, dessen erste Zeile `[!typ]` enthält. Der Blockquote-Render-Hook
macht daraus eine farbige Box mit Icon und Titel.

## Die Typen

```markdown
> [!note]
> So schreibst du eine Hinweisbox.
```

> [!note]
> Ein neutraler Hinweis. `note` ist der Standardtyp.

> [!info]
> Eine Information - wie `note`, nur in Blau.

> [!tip]
> Ein hilfreicher Tipp (`tip`).

> [!success]
> Hat geklappt! `success` ist für erledigte Dinge und Erfolge.

> [!important]
> Etwas Wichtiges (`important`), das man nicht überlesen sollte.

> [!warning]
> Eine Warnung (`warning`) - hier ist Vorsicht geboten.

> [!caution]
> `caution` - noch eine Stufe ernster.

> [!danger]
> Achtung, hier kann etwas kaputtgehen - `danger`.

> [!failure]
> Etwas ist fehlgeschlagen (`failure`).

> [!question]
> Eine offene Frage oder ein FAQ-Eintrag - `question`.

## Eigener Titel

Schreib den Titel hinter den Typ:

```markdown
> [!tip] Mein eigener Titel
> Inhalt der Box.
```

> [!tip] Mein eigener Titel
> Der Standardtitel ("Tipp") wird durch deinen Text ersetzt.

## Aufklappbar

Ein `+` macht die Box zu einem aufgeklappten `<details>`, ein `-` zu einem
zugeklappten:

```markdown
> [!info]- Zugeklappt - zum Aufklappen tippen
> Dieser Inhalt ist anfangs verborgen.
```

> [!info]- Zugeklappt - zum Aufklappen tippen
> Dieser Inhalt ist anfangs verborgen und klappt auf Klick aus.

> [!success]+ Aufgeklappt - kann zugeklappt werden
> Diese Box ist offen, lässt sich aber zuklappen.

## Aliase

Viele gebräuchliche Schreibweisen werden automatisch übersetzt, z. B.
`[!warning]`/`[!attention]`, `[!tip]`/`[!hint]`, `[!danger]`/`[!error]`,
`[!success]`/`[!check]`/`[!done]` oder `[!question]`/`[!faq]`.

> [!hint]
> `hint` ist ein Alias für `tip`.

Es gibt außerdem einen Typ `affiliate` für Werbehinweise - der wird vom Theme
auch automatisch oben in Beiträgen mit Affiliate-Links eingeblendet.