Zurück zum Blog

Markdown-Blockquotes erklärt: Der vollständige Leitfaden für Zitate

Die vollständige Anleitung zum Markdown von Blockquotes. Erfahren Sie mehr über Syntax, Verschachtelung, GitHub-Warnungen, Obsidian-Callouts, Stil, Plattformkompatibilität und jeden anderen Anwendungsfall, auf den Sie stoßen werden.

Benjamin McBrayer // Veröffentlicht: 24. April 202610 Min. Lesezeit

Ein Blockzitat ist eine Möglichkeit, Text hervorzuheben, der aus einer anderen Quelle stammt oder einer besonderen Hervorhebung bedarf, beispielsweise einem Zitat, einer Notiz oder einem Beispiel. In Markdown lassen sich Blockzitate einfach mit einem einfachen Symbol erstellen, was sie für Autoren, Blogger, Studenten und alle, die Inhalte online veröffentlichen, nützlich macht. Dieser Leitfaden zeigt Ihnen, was Blockquotes sind und wie Sie sie in Markdown richtig verwenden.

Kurze Antwort: Wie erstellt man ein Blockquote in Markdown?

Um im Markdown ein Blockzitat zu erstellen, fügen Sie am Anfang einer beliebigen Zeile ein Größer-als-Zeichen („>“) gefolgt von einem Leerzeichen ein. Die gesamte Zeile wird zu einem Block in Anführungszeichen.

> This is a blockquote.

Wird gerendert als:

Dies ist ein Blockzitat.

Das ist die gesamte Grundsyntax. Der Rest dieses Leitfadens behandelt mehrzeilige Anführungszeichen, Verschachtelung, GitHub-Warnungen, Obsidian-Callouts, Stil, Plattformkompatibilität und alle anderen Anwendungsfälle, denen Sie begegnen werden. Eine umfassendere Referenz finden Sie in unserem vollständigen Markdown-Cheatsheet.


Grundlegende Blockquote-Syntax in Markdown

Jedes Markdown-Blockzitat beginnt mit „>“ am Anfang einer Zeile.

> This is a single-line blockquote.

Wird gerendert als:

Dies ist ein einzeiliges Blockzitat.

Das Leerzeichen nach „>“ ist optional, wird aber empfohlen. Beide funktionieren in den meisten Parsern identisch:

> With a space
>Without a space

Für maximale Kompatibilität, insbesondere bei strengeren CommonMark-Parsern, schließen Sie immer das Leerzeichen ein.

Warum das „>“-Zeichen? Markdown hat seine Blockquote-Syntax von E-Mail-Konventionen übernommen. Wenn Sie auf eine E-Mail antworten, wird zitiertem Text oft das Präfix „>“ vorangestellt. Gruber behielt die Konvention bei, weil sie bereits jedem bekannt war, der seit den 1980er Jahren E-Mails nutzte.


Mehrzeilige Anführungszeichen in Markdown

Mehrere Zeilen im selben Absatz

Fügen Sie am Anfang jeder Zeile „>“ hinzu:

> This is line one of the blockquote.
> This is line two.
> This is line three.

Wird als einzelner Absatz gerendert:

Dies ist Zeile eins des Blockzitats. Das ist Zeile zwei. Das ist Zeile drei.

Lazy Continuation (nicht empfohlen)

Bei einigen Parsern können Sie das „>“ in Fortsetzungszeilen einfügen:

> This is line one.
This is line two (lazy style).

Dies funktioniert in CommonMark und GitHub Flavored Markdown, aber einige Parser scheitern daran. Stellen Sie aus Kompatibilitätsgründen immer jeder Zeile ein „>“ voran.

Blockzitate mit mehreren Absätzen

Trennen Sie mehrere Absätze innerhalb eines einzelnen Blockzitats durch eine Zeile, die nur „>“ enthält:

> This is the first paragraph of the blockquote.
>
> This is the second paragraph. Notice the blank `>` line above.
>
> And this is a third paragraph.

Wird gerendert als:

Dies ist der erste Absatz des Blockzitats.

Dies ist der zweite Absatz. Beachten Sie die leere „>“-Zeile oben.

Und das ist ein dritter Absatz.

Kritische Regel: Die Leerzeile zwischen den Absätzen muss weiterhin ein „>“-Zeichen enthalten. Ohne sie endet das Blockzitat und ein neues beginnt, was normalerweise nicht das ist, was Sie wollen.


Verschachtelte Markdown-Blockzitate

Stapeln Sie „>“-Zeichen, um Blockzitate ineinander zu verschachteln:

> This is the first-level quote.
>
> > This is a nested quote inside the first one.
> >
> > > And this is nested three levels deep.
>
> Back to the first level.

Wird gerendert als:

Dies ist das Zitat der ersten Ebene.

Dies ist ein verschachteltes Zitat im ersten.

Und das ist drei Ebenen tief verschachtelt.

Zurück zur ersten Ebene.

Eine Verschachtelung kommt in Antwortketten im E-Mail-Stil häufig vor, wobei jede Ebene von „>“ eine weitere Zitierrunde darstellt. In der Praxis wird es schwierig, tiefer als zwei oder drei Ebenen zu lesen. Erwägen Sie daher eine Umstrukturierung des Inhalts, bevor Sie vier Ebenen tief verschachteln.


Formatierung innerhalb von Markdown-Blockzitate

Blockquotes können die meisten anderen Markdown-Elemente enthalten. Platzieren Sie jedes Element in einer eigenen Zeile, immer noch mit dem Präfix „>“.

Textformatierung

> You can use **bold**, *italic*, ***bold italic***,
> ~~strikethrough~~, and `inline code` inside blockquotes.

Wird gerendert als:

Sie können fett, kursiv, fett kursiv, strikethrough und „Inline-Code“ innerhalb von Blockzitate.

Überschriften

> ### This is a heading inside a blockquote
>
> And this is regular text below it.

Wird gerendert als:

### Dies ist eine Überschrift innerhalb eines Blockzitats

Und das ist normaler Text darunter.

Listen

Sowohl geordnete als auch ungeordnete Listen funktionieren:

> **Quarterly Review:**
>
> - Revenue grew 23%
> - Headcount increased by 12
> - Customer churn dropped to 3%
>
> *All metrics are trending in the right direction.*

Wird gerendert als:

Vierteljährlicher Rückblick:

  • Umsatz stieg um 23 %
  • Mitarbeiterzahl um 12 erhöht
  • Die Kundenabwanderung sank auf 3 %

Alle Kennzahlen zeigen in die richtige Richtung.

Codeblöcke

Umzäunte Codeblöcke funktionieren innerhalb von Blockanführungszeichen, aber jede Zeile benötigt weiterhin das Präfix „>“:

> Run the following command to install:
>
> ```bash
> npm install markdown-it
>```
>
> Then restart your application.

Links und Bilder

> For more info, visit [our documentation](https://example.com).
>
> ![Logo](https://example.com/logo.png)

Was nicht zuverlässig funktioniert

  • Tabellen in Blockquotes funktionieren in GitHub Flavored Markdown, schlagen jedoch in strengeren Parsern fehl. Testen Sie, bevor Sie sich auf sie verlassen.
  • Horizontale Regeln in Blockzitate (---) sind mehrdeutig und werden inkonsistent dargestellt.
  • HTML-Blockelemente in Blockzitate verhalten sich Parser-übergreifend unvorhersehbar.

GitHub-Benachrichtigungen (Hinweise, Warnungen, Tipps)

GitHub Flavored Markdown (GFM) erweitert die Blockquote-Syntax um fünf spezielle Alarmtypen, die mit unterschiedlichen Farben und Symbolen auf GitHub, GitHub Issues, READMEs und Pull Requests gerendert werden.

Syntax

> [!NOTE]
> Useful information that users should know, even when skimming.

> [!TIP]
> Helpful advice for doing things better or more easily.

> [!IMPORTANT]
> Key information users need to know to achieve their goal.

> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.

> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.

Regeln für GitHub-Benachrichtigungen

– Der Alarmtyp („[!NOTE]“, „[!TIP]“ usw.) muss in einer eigenen Zeile am Anfang des Blockzitats stehen.

  • Bei Warnungstypen muss die Groß-/Kleinschreibung beachtet werden. „[!note]“ funktioniert nicht. – Die Warnung gilt für das gesamte folgende Blockquote.
  • Nur ein Alarmtyp pro Blockquote. Das Mischen von Typen wird nicht unterstützt.

Wann man die einzelnen Typen verwenden sollte

Warnung Verwenden Sie für
[!NOTE] Nützlicher Kontext, der nicht kritisch ist, aber dem Leser hilft
[!TIP] Optionaler Ratschlag, der etwas einfacher oder besser macht
[!IMPORTANT] Informationen, die der Leser kennen muss, um erfolgreich zu sein
[!WARNING] Etwas, das schief gehen könnte, wenn es ignoriert wird
[!ACHTUNG] Ernsthafte Risiken, Datenverlust, Sicherheitsprobleme, irreversible Maßnahmen

GitHub-Benachrichtigungen funktionieren in Repository-READMEs, Wiki-Seiten, Issues, Pull Requests und Diskussionen. Sie werden außerhalb von GitHub nicht als Warnungen gerendert, andernorts greifen sie auf normale Blockzitate zurück, wobei der Text „[!NOTE]“ als Klartext sichtbar ist.


Obsidian-Hinweise

Obsidian verwendet eine ähnliche Syntax wie GitHub-Benachrichtigungen, bietet jedoch weitaus mehr Optionen. Die Syntax lautet „> [!type]“, gefolgt vom Inhalt:

> [!note] Custom title here
> This is a note callout with a custom title.

> [!warning]
> This is a warning callout.

> [!tip] Pro tip
> Callouts can have custom titles for extra context.

Obsidian-Callout-Typen

Obsidian unterstützt über ein Dutzend Callout-Typen mit jeweils unterschiedlichen Farben und Symbolen:

  • „Notiz“, „Info“, „Zusammenfassung“, „Zusammenfassung“, „tldr“.
  • „Tipp“, „Hinweis“, „wichtig“.
  • „Erfolg“, „Überprüfen“, „Fertig“.
  • „Frage“, „Hilfe“, „FAQ“.
  • „Warnung“, „Vorsicht“, „Achtung“.
  • „Misserfolg“, „fehlgeschlagen“, „fehlt“.
  • „Gefahr“, „Fehler“.
  • „Fehler“.
  • „Beispiel“.
  • „Zitat“, „zitieren“.

Faltbare Beschriftungen

Fügen Sie nach dem Typ ein „+“ oder „-“ hinzu, um Callouts faltbar zu machen:

> [!note]+ Click to expand (starts open)
> Content hidden behind a toggle.

> [!warning]- Click to expand (starts closed)
> Collapsed by default.

Verschachtelte Callouts

Callouts können wie normale Blockzitate verschachtelt werden:

> [!note] Outer callout
> This is the outer content.
>
> > [!tip] Inner callout
> > This is nested inside.

Obsidian-Callouts sind der Grund, warum viele Markdown-Benutzer Obsidian zum Notieren bevorzugen. Sie verwandeln einfache Blockzitate in reichhaltige, gestaltete Informationsfelder.


Wann man Blockquotes verwendet

Blockzitate sind vielseitig. Hier sind die fünf häufigsten Situationen, in denen Sie sie verwenden werden, mit Beispielen, die Ihnen das Verständnis erleichtern.

1. Jemand anderes zitieren

Der ursprüngliche Zweck. Ordnen Sie Zitate ihrer Quelle zu, mit einer Zeile zur Namensnennung:

> The best way to predict the future is to invent it.
>
> Alan Kay

Wird gerendert als:

Der beste Weg, die Zukunft vorherzusagen, besteht darin, sie zu erfinden.

Alan Kay

Akademischer Stil mit korrekter Zitierung:

> Markdown is a text-to-HTML conversion tool for web writers. Markdown
> allows you to write using an easy-to-read, easy-to-write plain text
> format, then convert it to structurally valid XHTML (or HTML).
>
> John Gruber, [Daring Fireball](https://daringfireball.net/projects/markdown/)

2. Ziehen Sie Anführungszeichen in langen Inhalten

Heben Sie einen einprägsamen Satz aus dem Fließtext heraus, um visuelle Aufmerksamkeit zu erregen:

The team shipped the feature in record time. Morale soared. Revenue followed.

> In three months, we went from zero users to forty thousand.

What made the difference wasn't the code, it was the timing.

3. Callouts und Notizen

Bevor es GitHub-Benachrichtigungen gab, verwendeten die Leute Blockzitate mit fett gedruckten Beschriftungen, um Callouts zu erstellen:

> **Note:** This feature requires Node.js 18 or higher.

> **Warning:** Running this command will delete all data in the database.

> **Tip:** You can skip the setup step by using the `--auto` flag.

Wird immer noch häufig auf Plattformen verwendet, die GitHub-Benachrichtigungen nicht unterstützen.

4. Antworten und Zitate im E-Mail-Stil

In Diskussionen, Problemen und Pull-Requests:

> Should we use PostgreSQL or MySQL for this?

PostgreSQL, better JSON support and stronger type system.

5. Zitate mit Quellenangabe

Für akademisches, journalistisches oder technisches Schreiben:

> 78% of developers report using markdown daily.
>
> An interesting article on markdown, 2025

Blockzitate mit CSS gestalten

Bei Pure Markdown gibt es keine Styling-Optionen. Blockquotes rendern je nach Plattform. Die meisten Renderer verwenden standardmäßig einen linken Rand, grauen Text und etwas Abstand.

Individuelles Styling auf Ihrer eigenen Website

Wenn Sie Markdown auf einer von Ihnen kontrollierten Website veröffentlichen (Jekyll, Hugo, Ghost, Next.js und ähnliche), überschreiben Sie das CSS „

“:

blockquote {
  border-left: 4px solid #3498db;
  padding: 1em 1.5em;
  margin: 1.5em 0;
  background: #f8f9fa;
  font-style: italic;
  color: #555;
}

blockquote p:last-child {
  margin-bottom: 0;
}

Inline-HTML-Fallback

Wenn Sie einen bestimmten Blockquote-Stil innerhalb von Markdown benötigen und die Plattform rohes HTML zulässt:

<blockquote style="border-left: 4px solid #e74c3c; padding-left: 1em; color: #666;">
  This is a custom-styled quote.
</blockquote>

Dies funktioniert auf GitHub, den meisten statischen Site-Generatoren und Ghost. Es funktioniert nicht auf Reddit, Discord oder Slack (die Inline-HTML entfernen).


Plattformkompatibilität

Blockquotes sind eine der am häufigsten unterstützten Markdown-Funktionen. Sie funktionieren fast überall, allerdings mit wissenswerten plattformspezifischen Variationen.

| Platform       | Blockquotes | Nested | GitHub Alerts | Callouts    |
| -------------- | :---------: | :----: | :-----------: | :---------- |
| GitHub (GFM)   | Yes         | Yes    | Yes           | No          |
| GitLab         | Yes         | Yes    | Partial       | No          |
| Bitbucket      | Yes         | Yes    | No            | No          |
| Reddit         | Yes         | Yes    | No            | No          |
| Discord        | Yes         | No     | No            | No          |
| Slack          | Yes         | No     | No            | No          |
| Notion         | Yes         | Yes    | No            | No          |
| Obsidian       | Yes         | Yes    | As callout    | Yes         |
| Stack Overflow | Yes         | Yes    | No            | No          |
| Jekyll / Hugo  | Yes         | Yes    | Via plugin    | No          |

Plattformspezifische Hinweise

Discord unterstützt einzeilige und mehrzeilige Anführungszeichen, unterstützt jedoch keine Verschachtelung. Verwenden Sie „>“ für eine einzelne Zeile oder „>>>“ am Anfang für ein mehrzeiliges Zitat, das bis zum Ende der Nachricht fortgesetzt wird.

Slack stellt „>“ als Anführungszeichen dar, unterstützt jedoch keine Verschachtelung. Bei mehrzeiligen Anführungszeichen ist in jeder Zeile ein „>“ erforderlich.

Reddit erfordert zum Rendern eine Leerzeile vor jedem Blockquote. Dies ist der häufigste Grund, warum Blockquotes auf Reddit scheitern.

Notion konvertiert die „>“-Eingabe automatisch in einen eigenen Quote-Block. Bei verschachtelten Anführungszeichen müssen Blöcke ineinander gezogen werden.

Weitere Besonderheiten der Plattform finden Sie in unserem vollständigen Kompatibilitätsleitfaden im Pillar-Cheatsheet.


Häufige Fehler und Korrekturen

1. Blockquote wird nicht gerendert

Ursache: Fehlende Leerzeile vor oder nach dem Blockquote.

Gebrochen:

Here is regular text.
> This should be a blockquote.
More text.

Behoben:

Here is regular text.

> This should be a blockquote.

More text.

Die meisten Parser verzeihen dies, aber strengere Parser (einschließlich Reddit) erfordern Leerzeilen auf beiden Seiten.

2. Blockzitate mit mehreren Absätzen teilen sich in zwei Teile

Ursache: Die Leerzeile zwischen den Absätzen enthält kein „>“.

Gebrochen:

> First paragraph.

> Second paragraph (this becomes a separate blockquote).

Behoben:

> First paragraph.
>
> Second paragraph (now part of the same blockquote).

Die leere Trennzeile muss weiterhin „>“ enthalten.

3. GitHub-Warnung wird als einfaches Blockzitat gerendert

Ursache: Das Warnungs-Tag befindet sich in der falschen Zeile, ist falsch geschrieben oder enthält zusätzliche Leerzeichen.

Gebrochen:

> [!note]
> This is a note.

Der Typ muss in Großbuchstaben angegeben werden:

Behoben:

> [!NOTE]
> This is a note.

Überprüfen Sie außerdem, ob sich das Tag in einer eigenen Zeile befindet und nichts danach in derselben Zeile steht.

4. Verschachtelte Blockzitate werden auf eine Ebene reduziert

Ursache: Fehlende oder inkonsistente „>“-Zeichen in verschachtelten Zeilen.

Gebrochen:

> Outer quote.
>> Nested quote.

Fehlendes Leerzeichen zwischen „>“ und „>“:

Behoben:

> Outer quote.
>
> > Nested quote.

Setzen Sie beim Verschachteln immer ein Leerzeichen zwischen jedem „>“-Zeichen und fügen Sie vor dem Verschachteln eine leere „>“-Zeile ein.

5. Codeblock innerhalb von Blockquote-Unterbrechungen

Ursache: Fehlendes „>“ auf den Zaunlinien.

Gebrochen:

> Here's some code:
```Javascript
console.log("Hallo");```
> Back to the quote.

Behoben:

> Here's some code:
>
> ```Javascript
> console.log("Hallo");
>```
>
> Back to the quote.

Jede Linie, einschließlich der Zaunlinien, benötigt das Präfix „>“.

6. Faule Fortsetzungszeilen werden als normaler Absatz dargestellt

Ursache: Der Parser unterstützt keine verzögerte Fortsetzung.

Riskant:

> First line of the quote.
Second line without >.

Immer sicher:

> First line of the quote.
> Second line with >.

Best Practices für Markdown-Blockquote

Blockquotes sind eine der vielseitigsten Markdown-Funktionen. Sie unterstützen alles von einfachen Angeboten bis hin zu komplexen Hinweisen und Warnungen.

Wenn etwas nicht wie erwartet gerendert wird, überprüfen Sie die oben genannten allgemeinen Formatierungsregeln. Die meisten Probleme entstehen durch fehlende „>“-Zeichen oder Probleme mit den Abständen.


Häufig gestellte Fragen

Was ist ein Blockquote im Markdown?

Ein Blockzitat ist ein Textblock, der sich optisch vom umgebenden Inhalt abhebt, normalerweise durch einen linken Rand, einen Abstand und manchmal kursiven oder gedämpften Text. Im Markdown wird jede Zeile, die mit „>“ beginnt, Teil eines Blockzitats.

Kann ich Blockzitate im Markdown verschachteln?

Ja. Fügen Sie ein weiteres „>“ für jede Verschachtelungsebene hinzu, „> >“ für zwei Ebenen, „> > >“ für drei usw. Fügen Sie zwischen jedem „>“-Zeichen immer ein Leerzeichen ein.

Wie beende ich ein Blockzitat?

Lassen Sie nach der letzten zitierten Zeile eine Leerzeile (ohne „>“). Die nächste Textzeile wird ein normaler Absatz sein.

Kann ich Codeblöcke in ein Blockzitat einfügen?

Ja. Verwenden Sie eingezäunte Codeblöcke (dreifache Backticks) und stellen Sie jeder Zeile, einschließlich der Zaunlinien, ein „>“ voran.

Warum wird meine GitHub-Warnung nicht farbig angezeigt?

GitHub-Warnungen werden nur auf GitHub selbst gerendert (einschließlich GitHub Issues, Pull Requests, Wikis und READMEs). Außerhalb von GitHub greifen sie auf normale Blockzitate zurück, wobei der Text „[!NOTE]“ sichtbar ist. Überprüfen Sie außerdem, ob der Alarmtyp in Großbuchstaben geschrieben ist und sich in einer eigenen Zeile befindet.

Was ist der Unterschied zwischen einem Blockquote und einem Callout?

Ein Blockquote ist ein Standard-Markdown („>“). Ein Callout ist eine gestaltete Variante. GitHub-Benachrichtigungen und Obsidian-Callouts verwenden die Blockquote-Syntax mit einem zusätzlichen Tag („[!NOTE]“, „[!warning]“), um einen speziellen Stil auszulösen. Callouts sind Plattformerweiterungen, kein Kernabschlag.

Wie zitiere ich jemanden und füge Namensnennung hinzu?

Fügen Sie nach dem Zitat eine Zeile mit der Quelle hinzu:

> Premature optimization is the root of all evil.
>
> Donald Knuth

Kann ich Blockzitate mit benutzerdefinierten Farben gestalten?

Nicht mit reinem Markdown, Blockquotes erben den Stil, den die Plattform anwendet. Überschreiben Sie auf einer von Ihnen kontrollierten Website das CSS „

“. Verwenden Sie in Markdown-Inhalten rohes HTML mit Inline-Stilen, sofern die Plattform dies zulässt.

Funktionieren Blockquotes in allen Markdown-Varianten?

Ja. Blockquotes sind Teil der ursprünglichen Spezifikation von John Gruber und werden von jedem Markdown-Parser unterstützt, einschließlich CommonMark, GFM, MultiMarkdown, Pandoc und Plattformvarianten wie Discord, Slack und Reddit.

Warum bricht mein Blockquote auf Reddit ab?

Reddit verlangt eine Leerzeile vor jedem Blockquote. Außerdem ist der Markdown von Reddit strenger als der von GFM. Wenn das „>“ nicht am Anfang einer Zeile beginnt (ohne führende Leerzeichen), wird es nicht gerendert.

Kann ich ein leeres Blockzitat haben?

Technisch gesehen erzeugt „>“ in einer eigenen Zeile einen leeren Block in Anführungszeichen, ist aber selten nützlich. Die meisten Parser rendern lediglich einen dünnen Rahmen ohne Inhalt.

Wie lang sollte ein Blockquote sein?

Es gibt keine technische Grenze. Stilistisch gesehen eignen sich kurze Zitate (ein oder zwei Sätze) gut als Anführungszeichen. Längere Zitate (ein Absatz oder mehr) eignen sich für erweiterte Zitate. Wenn ein Zitat länger als ein paar Absätze ist, sollten Sie es stattdessen paraphrasieren oder zusammenfassen.