Obsidian Callouts: Syntax, Typen, Beispiele & Benutzerdefiniertes CSS

Mit Obsidian Callouts (Hervorhebungsblöcken) können Sie bestimmte Inhalte in Ihren Notizen mithilfe einer einfachen, auf Zitaten (Blockquotes) basierenden Syntax hervorheben, gruppieren und ausblenden. Egal, ob Sie Aufmerksamkeit auf Prüfungstipps lenken, einklappbare Aufgabenlisten erstellen oder Autorennotizen vom Manuskripttext trennen möchten — Callouts bieten eine flexible Möglichkeit, Informationen visuell zu strukturieren, ohne Ihren Schreibfluss zu unterbrechen.

Schnelle Antwort: Wie erstellt man ein Obsidian Callout?

Ja. Obsidian Callouts sind gestaltete Zitatblöcke, die > [!type] in der ersten Zeile verwenden. Dieser Leitfaden bietet Ihnen die Syntax, Copy-Paste-Beispiele, integrierte Typen, Regeln zum Einklappen und Verschachteln sowie Lösungen für häufige CSS-Probleme. Nutzen Sie die offizielle Callout-Referenz, um die aktuelle Typenliste und Editor-Befehle zu überprüfen.

Hier ist die grundlegende Syntax zur Erstellung eines Callouts:

> [!note] Dies ist ein Callout.

• Verwenden Sie > [!type] in der ersten Zeile eines Zitatblocks.

• Ersetzen Sie note durch einen anderen Typ wie tip, warning oder question.

• Drücken Sie Eingabe und fahren Sie mit > fort, um mehrzeiligen Inhalt einzufügen.

• Verwenden Sie in der Live-Vorschau die Befehlspalette und wählen Sie Insert callout, um sofort einen Standard-Callout-Block einzufügen. Sie können auch bestehenden Text markieren und denselben Befehl ausführen, um ihn in ein Callout einzuschließen.

Was sind Obsidian Callouts?

Callouts sind gestaltete Zitatblöcke, die Obsidian mit Farben, Icons und optionalem Einklappverhalten rendert. Sie wurden Mitte 2022 eingeführt und sind zu einer Kernfunktion für die visuelle Organisation von Notizen geworden.

Wenn Obsidian auf einen Zitatblock stößt, der mit [!type] beginnt, wird dieser speziell verarbeitet und als Callout-Box anstelle eines einfachen Zitatblocks dargestellt. Im Textkörper können Sie Standard-Markdown-Syntax, Wikilinks, Einbettungen, Aufgaben, Codeblöcke und interne Links verwenden.

Visuell wird ein Callout mit einer farbigen Seitenleiste, einem Icon (wie einer Glühbirne für Tipps oder einem Ausrufezeichen für Warnungen), einer optionalen Titelleiste und dem darunter liegenden Textkörper angezeigt.

Häufige Anwendungen sind:

• Zusammenfassung von Hauptpunkten am Anfang von Meeting-Notizen.

• Hervorhebung prüfungsrelevanter Inhalte in Lernnotizen.

• Hinzufügen von Spoiler-Boxen in Buchanmerkungen.

Beachten Sie, dass Callouts nur in Obsidian gerendert werden. In einfachen Markdown-Viewern oder auf GitHub erscheinen sie als normale verschachtelte Zitatblöcke — der Inhalt bleibt lesbar, nur ohne Styling.

Callout-Syntax und Konfiguration

Dieser Abschnitt behandelt alle Syntaxelemente: Typ, Titel, Einklappen und Inhalt.

Die Grundstruktur sieht so aus:

> [!note] Titeltext
> Hier steht der Inhalt
> - Aufzählungspunkte funktionieren auch

Die erste Zeile enthält drei Elemente:

• Typ-Bezeichner in eckigen Klammern: [!note], [!warning], [!tip]

• Optionaler Einklapp-Marker: + oder - direkt nach dem Typ (z. B. [!tip]-)

• Optionaler benutzerdefinierter Titel nach dem Typ (z. B. [!tip] Prüfungshinweis)

Zeilen des Textkörpers beginnen wie normale Zitatblöcke mit > und können Aufzählungspunkte, Codeblöcke, Bilder oder Aufgaben-Kontrollkästchen enthalten.

Das Schlüsselwort für den Typ unterscheidet nicht zwischen Groß- und Kleinschreibung — [!NOTE], [!Note] und [!note] funktionieren bei integrierten Callouts identisch.

Callout-Titel ändern

Standardmäßig verwendet Obsidian den Typnamen als Titel (z. B. „Note“ oder „Warning“).

So überschreiben Sie den Standardtitel:

> [!warning] Vor dem Deployment lesen

Vergleichen Sie diese beiden Ansätze:

• > [!tip] wird mit der Standardüberschrift „Tip“ angezeigt.

• > [!tip] Schnellerer Workflow zeigt stattdessen „Schnellerer Workflow“ an.

Ein Callout nur mit Titel funktioniert ebenfalls — verwenden Sie einfach eine einzelne Zeile wie > [!info] Systemanforderungen ohne nachfolgende Inhaltszeilen.

Titel können Emojis, Wikilinks und Formatierungen wie Fettdruck enthalten.

Einklappbare (Collapsible) Callouts

Das Hinzufügen eines Plus- oder Minuszeichens direkt nach dem Typ steuert, ob das Callout eingeklappt werden kann:

• > [!note]+ Standardmäßig ausgeklappt

• > [!note]- Standardmäßig eingeklappt

Beide Marker machen das Callout einklappbar. Das Vorzeichen bestimmt, ob es geöffnet oder geschlossen startet.

Praktische Anwendungen für einklappbare Callouts sind:

• Ausblenden detaillierter Lösungen in Lernnotizen.

• Einklappen langer Checklisten unter einer [!todo]- Überschrift.

• Verbergen von Spoilern in Buchnotizen.

Im Lese- und Live-Vorschau-Modus klicken Benutzer auf das Dreieck-Icon, um das Callout aus- oder einzuklappen. Im Quelltext-Modus erscheint der Einklapp-Marker als rohes Markdown.

Verschachtelte Callouts

Sie können Callouts verschachteln, indem Sie einen weiteren Callout-Block in den Textkörper eines übergeordneten Callouts einfügen.

Die inneren Callout-Zeilen verwenden für jede Verschachtelungsebene ein zusätzliches >:

> [!warning] Mögliches Problem
>> [!tip] Hier ist ein Workaround

Dies erzeugt ein Warnungs-Callout, das einen verschachtelten Tipp enthält. Ein weiteres Beispiel: ein [!question] mit verschachtelten [!example] Antworten.

Begrenzen Sie die Verschachtelungstiefe aus Gründen der Lesbarkeit — zwei Ebenen reichen in der Regel aus.

Unterstützte Callout-Typen in Obsidian

Obsidian wird mit integrierten Typen geliefert, die jeweils einer Farbe und einem Icon zugeordnet sind. Nicht unterstützte Typen fallen auf das Styling von note zurück.

Häufige Standardtypen und ihre Aliase:

• note: allgemeine Informationen

• abstract / summary / tldr: Zusammenfassungen

• info: zusätzlicher Kontext

• todo: Aufgaben und Action Items

• tip / hint / important: Ratschläge und Kernpunkte

• success / check / done: erledigte Elemente

• question / help / faq: Fragen

• warning / caution / attention: potenzielle Probleme

• failure / fail / missing: fehlende Informationen

• danger / error: schwerwiegende Probleme

• bug: Software-Bugs

• example: Code- oder Konzeptbeispiele

• quote / cite: hervorgehobene Zitate

Verschiedene Community-Themes können diese Typen unterschiedlich gestalten, sodass dasselbe [!warning] in verschiedenen Themes anders aussehen kann.

In der Live-Vorschau können Sie mit der rechten Maustaste auf die Leiste eines Callouts klicken, um dessen Typ über ein Kontextmenü zu ändern, anstatt das Markdown manuell zu bearbeiten.

Unbekannte Typen wie [!idea] werden visuell als note dargestellt, bleiben aber für CSS-Targeting verfügbar.

Welches Callout sollten Sie verwenden?

Der Typ steuert das Signal, nicht nur die Farbe. Wählen Sie eine kleine Konvention, die Ihnen beim späteren Durchsuchen der Notiz sofort sagt, was zu tun ist:

Was Sie signalisieren möchten	Guter Starttyp	Nützliches Muster
Kontext oder eine Definition	info oder abstract	Platzieren Sie die Erklärung neben der Behauptung, die sie stützt.
Eine nächste Aktion	todo	Halten Sie die Checkliste nah am Projekt- oder Meeting-Kontext.
Eine Entscheidung oder ein Risiko	question, warning oder eigener Typ	Machen Sie den offenen Punkt sichtbar, ohne ihn im Text zu begraben.
Ein Detail, das nur selten gebraucht wird	Einklappbares example oder note	Nutzen Sie -, um Zusatzdetails standardmäßig einzuklappen.
Ein abgeschlossenes Ergebnis	success oder done	Reservieren Sie es für ein Ergebnis, nicht für jeden positiven Satz.

Für ein produktives Vault ist eine praktische Minimalausstattung todo für Aktionen, warning für Blockaden, question für offene Entscheidungen und summary für Review-Notizen.

Praktische Möglichkeiten zur Nutzung von Callouts

So fügen sich Callouts in reale Workflows ein:

• Studium und Lernen: Nutzen Sie [!tip] für Prüfungshinweise, [!question]- für Übungsfragen mit eingeklappten Lösungen, [!summary] am Anfang von Vorlesungsnotizen.

• Softwareentwicklung: Verwenden Sie [!warning] um destruktive Befehle, [!bug] für bekannte Probleme, [!example] für Code-Snippets.

• Projekt- und Aufgabenmanagement: Speichern Sie Checklisten in [!todo]+ Callouts nach Meilensteinen und wandeln Sie sie nach Fertigstellung in [!success] um.

• Schreiben langer Texte: Trennen Sie Autorennotizen mit [!note]- ab oder markieren Sie Plot-Hinweise in Entwürfen.

• Persönliche Wissensdatenbank: Nutzen Sie [!info] für Kernfakten, [!quote] für Zitate, [!danger] für kritische Warnungen.

Kombinieren Sie vorbereitete Obsidian-Vorlagen, die Callouts bereits in Notizstrukturen integrieren. Für Meeting-Workflows lesen Sie unsere Anleitung für Obsidian Meeting-Vorlagen.

Callouts für Aufgaben und Checklisten

Aufgaben innerhalb von Callouts verhalten sich wie normale Obsidian-Aufgaben und erscheinen in der globalen Aufgabensuche.

Ein [!todo] Callout gruppiert zusammengehörige Kontrollkästchen:

> [!todo]+ Release 1.2 Checkliste
> - [ ] CHANGELOG für Release 2025-04-01 aktualisieren
> - [ ] Regressionstests ausführen

Ändern Sie den Typ von todo zu success, um den Abschluss eines gesamten Blocks visuell zu signalisieren.

Callouts in Publikations-Workflows

Callouts sind interne Bearbeitungswerkzeuge und sollten in finalen Exporten wie Büchern, PDFs oder Blogbeiträgen oft nicht erscheinen.

Plugins wie Longform ermöglichen das Hinzufügen eines Vorverarbeitungsschritts, um Callout-Markup vor dem Kompilieren zu entfernen. Ein Skript entfernt Zeilen, die mit > [! beginnen, während der Inhalt erhalten bleibt oder verworfen wird.

Anpassen von Callouts mit CSS

Obsidian stellt Callouts über data-callout-Attribute bereit, sodass Sie eigene Typen mit benutzerdefiniertem CSS definieren können.

Das Muster:

1. Wählen Sie einen eigenen Bezeichner wie idea.

2. Verwenden Sie ihn in Notizen: > [!idea] Neues Produktkonzept

3. Sprechen Sie in CSS .callout[data-callout="idea"] an mit eigenen Farben und Icons.

Obsidian verwendet Lucide-Icons. Die unterstützte CSS-API nutzt --callout-color und --callout-icon; die Entwicklerreferenz für Callout CSS-Variablen listet verfügbare Variablen auf.

Beispiele für nützliche benutzerdefinierte Callouts

Konkrete Ideen für eigene Typen:

• [!clue]: Für Autoren zur Verfolgung von Hinweisen über Kapitel hinweg.

• [!risk]: In der Dokumentation zur Kennzeichnung technischer oder geschäftlicher Risiken.

• [!meeting]: Für Aktionszusammenfassungen am Anfang datierter Meeting-Notizen.

• [!definition]: In einer Wissensdatenbank zur Standardisierung von Begriffserklärungen.

Fügen Sie diese Styles als CSS-Snippet im Ordner .obsidian/snippets Ihres Vaults hinzu.

CSS-Fehlerbehebung

Prüfen Sie Folgendes der Reihe nach:

1. Legen Sie die CSS-Datei in den Ordner .obsidian/snippets des Vaults, aktivieren Sie sie unter Einstellungen → Erscheinungsbild → CSS-Snippets und laden Sie die Snippets neu.
2. Stimm der Typ in der Notiz und im Selektor exakt überein. Beispiel: [!decision] erfordert .callout[data-callout="decision"].
3. Halten Sie benutzerdefinierte Typnamen an beiden Stellen in Kleinbuchstaben. Eingebaute Bezeichner unterscheiden nicht zwischen Groß- und Kleinschreibung, aber ein Bericht zur Fehlerbehebung im Obsidian-Forum zeigt, dass eine Groß-/Kleinschreibungsabweichung verhindern kann, dass ein benutzerdefinierter Selektor übereinstimmt.
4. Verwenden Sie ein Icon, das in Ihrer installierten Obsidian-Version enthalten ist.

Suchen, Verwalten und Exportieren von Callouts

Suchen Sie nach Callouts mit Abfragen wie "[!todo]" um alle Todo-Callouts zu finden. Kombinieren Sie dies mit Pfadfiltern: path:"Drafts" "[!clue]".

Einschränkungen und Kompatibilität

Callouts sind kein Bestandteil von Standard-CommonMark. In Editoren wie Typora oder auf GitHub werden sie zu einfachen verschachtelten Zitaten degradiert.

Einige mobile Markdown-Apps zeigen sie als einfachen Text an — der Inhalt bleibt lesbar, jedoch ohne Farben oder Icons.

Die intensive Nutzung verschachtelter und einklappbarer Callouts kann das Rendering auf älteren Mobilgeräten verlangsamen.

Testen Sie Exporte (PDF, DOCX, HTML) regelmäßig, um zu überprüfen, ob kritische Inhalte innerhalb von Callouts korrekt angezeigt werden. Erwägen Sie das Führen eines Styleguide-Dokuments in Ihrem Vault, damit alle Beteiligten dieselben Konventionen befolgen.

Häufige Syntaxfehler

Der Einklapp-Marker muss direkt an den Typ-Bezeichner anschließen:

> [!faq]- Standardmäßig eingeklappt
> Dieser Inhalt ist zu Beginn ausgeblendet.

> [!faq] - Standardmäßig eingeklappt enthält ein Leerzeichen vor dem Bindestrich und entspricht daher nicht der dokumentierten Einklapp-Syntax. Wenn das Einklappen weiterhin nicht funktioniert, prüfen Sie, ob sich die Notiz im Lese- oder Live-Vorschau-Modus befindet, und vergleichen Sie den Block mit dem offiziellen Beispiel. Ein Obsidian-Forum-Bericht 2024 identifizierte das zusätzliche Leerzeichen als Ursache für ein nicht einklappbares Callout.

Callouts sind eine Obsidian-Erweiterung und gehören nicht zum Standard-CommonMark. Wenn ein Callout in einem anderen Markdown-Editor wie ein einfaches Zitat aussieht, ist das zu erwarten; der Inhalt bleibt lesbar, aber das Obsidian-Styling und das Einklappverhalten werden nicht übernommen.

Fazit

Obsidian Callouts sind erweiterte Zitatblöcke, mit denen Sie Informationen hervorheben, gruppieren und optional ausblenden können, ohne Ihren Notizfluss zu stören.

Wichtigste Erkenntnisse:

• Lernen Sie die Basissyntax: > [!type] Titel

• Wählen Sie ein kleines Set von Typen, das zu Ihrem Workflow passt

• Fügen Sie benutzerdefiniertes CSS nur dort hinzu, wo es Ihren Prozess unterstützt

Wenn Sie verknüpfte Tagesnotizen, Projekte, Reviews und Meeting-Vorlagen von Anfang an nutzen möchten, bietet Obsibrain ein fertiges Local-First-System für Obsidian.