## Referenz

GitHub Markdown Callouts

Veroeffentlicht Maerz 2026

GitHub hat Callout-(Alert-)Syntax zu GitHub Flavored Markdown hinzugefuegt. Diese gestylten Boxen heben wichtige Informationen in der Dokumentation hervor — Hinweise, Tipps, Warnungen und mehr. ShowMeMyMD ist einer der wenigen Desktop-Viewer, die sie rendern.

## Die Syntax

Fuenf Callout-Typen

Callouts nutzen Blockquote-Syntax mit einem speziellen Tag in der ersten Zeile. Das Format ist immer gleich: > [!TYPE] gefolgt von deinem Inhalt in der naechsten Zeile, ebenfalls mit > vorangestellt.

> [!NOTE]
> Nuetzliche Information, die Nutzer wissen sollten,
> auch wenn sie den Inhalt nur ueberfliegen.

NOTE — Wird als blaue Info-Box gerendert. Verwende es fuer zusaetzlichen Kontext, der hilfreich, aber nicht kritisch ist. Denke an 'uebrigens'-Informationen.

> [!TIP]
> Hilfreicher Rat, um Dinge besser
> oder einfacher zu machen.

TIP — Wird als gruene Vorschlags-Box gerendert. Verwende es fuer Best Practices, Abkuerzungen oder Empfehlungen, die dem Leser das Leben erleichtern.

> [!IMPORTANT]
> Schluesselinformation, die Nutzer wissen muessen,
> um ihr Ziel zu erreichen.

IMPORTANT — Wird als lila Hervorhebungs-Box gerendert. Verwende es fuer Informationen, die man vor dem Weitermachen unbedingt verstehen muss. Keine Warnung, aber etwas, das man nicht ueberspringen darf.

> [!WARNING]
> Dringende Information, die sofortige
> Aufmerksamkeit erfordert, um Probleme zu vermeiden.

WARNING — Wird als gelbe Alarm-Box gerendert. Verwende es fuer moegliche Probleme, Fallstricke oder Dinge, die schiefgehen koennten, wenn der Leser nicht aufpasst.

> [!CAUTION]
> Warnt vor Risiken oder negativen Folgen
> bestimmter Aktionen.

CAUTION — Wird als rote Gefahr-Box gerendert. Reserviere dies fuer irreversible Operationen, Datenverlust-Szenarien oder Aktionen, die Dinge kaputt machen koennten.

## Nutzungstipps

Effektive Callouts schreiben

Sparsam einsetzen

Zu viele Callouts erzeugen visuelles Rauschen. Wenn alles wichtig ist, ist nichts wichtig. Eine Seite voller farbiger Boxen trainiert Leser, sie zu ignorieren. Ein oder zwei pro Abschnitt ist normalerweise die richtige Menge.

Typ dem Schweregrad anpassen

Verwende CAUTION nicht fuer einen kleinen Tipp. Verwende NOTE nicht fuer etwas, das eine Datenbank loeschen koennte. Die Farbcodierung existiert, um Lesern ein sofortiges Signal ueber den Schweregrad zu geben — respektiere das.

Inhalt kurz halten

Callouts funktionieren am besten mit ein bis drei Saetzen. Wenn du mehrere Absaetze brauchst, gehoert die Information wahrscheinlich in den Haupttext, nicht in eine Callout-Box.

Andere Elemente verschachteln

Code-Spans, Links, Fett und Kursiv funktionieren alle innerhalb von Callouts. Stelle jeder Zeile > voran, um den Inhalt innerhalb des Callout-Blocks zu halten.

## Kompatibilitaet

Wo Callouts gerendert werden

Tool	Callout-Unterstuetzung
GitHub (Web)	Vollstaendig — farbige Boxen mit Icons
ShowMeMyMD	Vollstaendig — gestylte Callouts auf dem Desktop
Einige VS Code Erweiterungen	Variiert je nach Erweiterung
Die meisten anderen Markdown-Viewer	Nein — zeigt ein einfaches Blockquote
Standard CommonMark Renderer	Nein — einfaches Blockquote
Aeltere GFM-Parser	Nein — einfaches Blockquote

Die meisten Markdown-Viewer zeigen nur ein Blockquote.

ShowMeMyMD rendert den vollstaendig gestylten Callout — farbige Seitenleiste, Icon und ordentliche Formatierung — genau wie er auf GitHub erscheint. Wenn du READMEs oder Dokumentation mit Callouts schreibst, ist dies eine der wenigen Moeglichkeiten, sie lokal auf dem Mac in der Vorschau anzuzeigen.

## Weiterlesen

Erfahre mehr ueber ShowMeMyMD als Markdown-Viewer fuer Mac. Sieh warum Entwickler es als ihren Entwickler-Markdown-Viewer waehlen. Oder speichere unser Markdown Cheat Sheet als Lesezeichen.

Callouts lokal in der Vorschau anzeigen

Hoer auf, zu GitHub zu pushen, nur um zu pruefen, wie deine Callouts aussehen. ShowMeMyMD rendert NOTE, TIP, IMPORTANT, WARNING und CAUTION — direkt auf deinem Mac. $2.99 im Mac App Store.