Max Mustermann
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 #
> [!note]
> So schreibst du eine Hinweisbox.
Ein neutraler Hinweis. note ist der Standardtyp.
Eine Information - wie note, nur in Blau.
Ein hilfreicher Tipp (tip).
Hat geklappt! success ist für erledigte Dinge und Erfolge.
Etwas Wichtiges (important), das man nicht überlesen sollte.
Eine Warnung (warning) - hier ist Vorsicht geboten.
caution - noch eine Stufe ernster.
Achtung, hier kann etwas kaputtgehen - danger.
Etwas ist fehlgeschlagen (failure).
Eine offene Frage oder ein FAQ-Eintrag - question.
Eigener Titel #
Schreib den Titel hinter den Typ:
> [!tip] Mein eigener Titel
> Inhalt der Box.
Der Standardtitel (“Tipp”) wird durch deinen Text ersetzt.
Aufklappbar #
Ein + macht die Box zu einem aufgeklappten <details>, ein - zu einem
zugeklappten:
> [!info]- Zugeklappt - zum Aufklappen tippen
> Dieser Inhalt ist anfangs verborgen.
Zugeklappt - zum Aufklappen tippen
Dieser Inhalt ist anfangs verborgen und klappt auf Klick aus.
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 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.
