Blockzitate in Markdown: Zitate, mehrere Absätze und Listen
Schreiben Sie Markdown-Zitate mit >, verschachteln Sie Blockzitate und zitieren Sie mehrere Absätze. Unterscheiden Sie GitHub-Hinweise vor dem Word-Export von portabler Syntax.
Ein Markdown-Blockzitat beginnt mit > und einem anschließenden Leerzeichen. Setzen Sie die Markierung an den Anfang jeder zitierten Zeile, damit der Quelltext leicht lesbar und bearbeitbar bleibt.
> Die überarbeitete Installationsanleitung ist zur Prüfung bereit.
Das Ergebnis ist ein zitierter Absatz, kein Codeblock. Randlinie, Einrückung und Farbe hängen vom Design der Seite oder des Dokuments ab. Der Zitattext bleibt gewöhnliches Markdown und kann daher Hervorhebungen, Links, Listen und andere Dokumentstrukturen enthalten.
Probieren Sie die Beispiele im Markdown-Viewer aus. Wenn Sie eine bearbeitbare Fassung zur Prüfung benötigen, exportieren Sie das Dokument anschließend mit dem Markdown-zu-Word-Konverter.
Einen Absatz über mehrere Quelltextzeilen zitieren
Wiederholen Sie bei einem längeren Zitat die Markierung:
> Die überarbeitete Installationsanleitung ist zur Prüfung bereit.
> Bitte prüfen Sie die Voraussetzungen vor der Freigabe der Version.
Diese beiden Quelltextzeilen bilden in der Vorschau dieser Website einen Absatz. Ein Zeilenwechsel im Quelltext erzwingt nicht unbedingt einen sichtbaren Zeilenumbruch. Soll der Text auf zwei Zeilen bleiben, fügen Sie einen ausdrücklichen Umbruch ein:
> Prüfung der Dokumentation\
> Der Release-Leitung zugewiesen
Der Backslash steht vor dem Zeilenwechsel; die nächste Zeile beginnt weiterhin mit der Zitatmarkierung. Unter Zeilenumbrüche in Markdown finden Sie den Unterschied zwischen harten Zeilenumbrüchen und Absatzumbrüchen.
Mehrere Absätze in einem Zitat zusammenfassen
Setzen Sie eine Zitatmarkierung auf die ansonsten leere Zeile zwischen den Absätzen:
> Der erste Entwurf beschreibt den Installationsablauf.
>
> Der zweite Entwurf ergänzt Schritte zur Fehlerbehebung und Beispiele.
Dadurch entsteht ein Blockzitat mit zwei Absätzen. Das > auf der Trennzeile macht die beabsichtigte Zusammengehörigkeit sichtbar, besonders wenn jemand die Passage später bearbeitet.
Um mit Ihrem eigenen Text fortzufahren, lassen Sie eine Zeile leer und schreiben ohne Markierung weiter:
> Bei der Prüfung wurde ein kürzerer Installationsabschnitt gewünscht.
Wir haben die ausführlichen Konfigurationshinweise in einen Anhang verschoben.
Entfernen Sie > nicht von einer Fortsetzungszeile, ohne eine Leerzeile einzufügen. Manche Markdown-Parser behandeln dies als implizite Fortsetzung des zitierten Absatzes. Die CommonMark-Spezifikation zu Blockzitaten beschreibt dieses Verhalten. Explizite Markierungen und eine eindeutige Leerzeile erleichtern die gemeinsame Pflege.
Hervorhebungen, Links und Quellenangaben ergänzen
Innerhalb eines Blockzitats können Sie die üblichen Inline-Formatierungen verwenden:
> **Anmerkung zur Prüfung:** Die Migrationsschritte benötigen ein funktionierendes Beispiel.
> Siehe die [Freigabecheckliste](https://example.com/checklist).
>
> Rückmeldung aus der Dokumentationsprüfung, September 2026.
Markdown weist der letzten Zeile keine besondere Rolle als Quellenangabe zu. Sie ist gewöhnlicher Absatzinhalt innerhalb des Zitats. Ergänzen Sie bei Bedarf Quelle, Autor und Link und prüfen Sie die erforderlichen Rechte, bevor Sie die Passage einer anderen Person wiedergeben.
Ein Blockzitat fügt auch keine wörtlichen Anführungszeichen hinzu. Geben Sie diese selbst ein, wenn das fertige Dokument sie benötigt. Für ein kurzes Zitat innerhalb Ihres eigenen Satzes reichen möglicherweise einfache Anführungszeichen, ohne einen eigenen Block anzulegen.
Ein Zitat verschachteln oder eine Liste einfügen
Verwenden Sie eine weitere >-Ebene für zitiertes Material innerhalb des äußeren Zitats:
> Die prüfende Person fasste die frühere Anforderung zusammen:
>
> > Ein vollständiges Beispiel der Konfigurationsdatei ergänzen.
>
> Der aktualisierte Entwurf enthält nun dieses Beispiel.
Halten Sie Verschachtelungen in einem Bericht flach. Tief verschachtelte Zitate verringern die verfügbare Textbreite und können PDF- und Word-Dokumente schwerer lesbar machen.
Bei einer Liste innerhalb eines Zitats bleibt die Markierung auf jeder Zeile erhalten:
> Die Prüfung ergab zwei Änderungen:
>
> - Die erforderlichen Berechtigungen erklären.
> - Einen Abschnitt zur Fehlerbehebung ergänzen.
Für die umgekehrte Struktur, ein Zitat innerhalb einer Liste, rücken Sie es unter dem Text des Listeneintrags ein:
- Rückmeldung zur Dokumentation
> Vor der Veröffentlichung einen Abschnitt zur Fehlerbehebung ergänzen.
- Freigabecheckliste
Erscheint das Zitat außerhalb des Eintrags, vergleichen Sie seine Einrückung mit den Beispielen in der Anleitung zur Markdown-Einrückung.
GitHub-Hinweise brauchen Unterstützung im Zielsystem
GitHub unterstützt spezielle Hinweise auf Grundlage der Zitatsyntax, darunter diese Form:
> [!NOTE]
> Sichern Sie die Konfiguration, bevor Sie sie ändern.
GitHub dokumentiert die unterstützten Typen in seiner Referenz zu Hinweisen. Farben und Symbole solcher Hinweise sind Plattformfunktionen und keine allgemeine Eigenschaft jedes Markdown-Zitats.
Der Renderer dieser Website ergänzt nicht die Gestaltung der GitHub-Hinweise. Das Beispiel bleibt ein Blockzitat mit sichtbarem [!NOTE]-Label. Soll ein Dokument auf verschiedenen Zielsystemen gut lesbar bleiben, verwenden Sie eine ausdrückliche fettgedruckte Bezeichnung:
> **Hinweis:** Sichern Sie die Konfiguration, bevor Sie sie ändern.
So bleibt die Bedeutung auch ohne besondere Hinweiserweiterung verständlich. Dasselbe Vorgehen eignet sich für eine Warnung, eine Prüfentscheidung oder eine redaktionelle Anmerkung.
Zitatprobleme vor dem Export beheben
Wird > wörtlich angezeigt, prüfen Sie, ob das Beispiel zwischen Backticks, in einem mit Codezäunen begrenzten Codeblock oder in einem eingerückten Codeblock steht. Diese Kontexte dienen der Anzeige von Quelltext. Auch ein Backslash vor der Markierung maskiert sie.
Wird zu viel Text zitiert, fügen Sie vor dem Absatz, der außerhalb des Zitats fortfahren soll, eine Leerzeile ein. Ist verschachteltes Material schwer nachvollziehbar, verringern Sie die Verschachtelung und ergänzen Sie die Quellenangabe als gewöhnlichen Absatz.
Öffnen Sie abschließend die exportierte DOCX-Datei und prüfen Sie lange Zitate sowie zitierte Listen. Die linke Randlinie im Browser kann sich von der Absatzgestaltung im Word-Dokument unterscheiden. Nutzen Sie das Markdown-zu-HTML-Tool, um die Zwischenstruktur zu prüfen, wenn Sie ein Problem der Quellformatierung von einem Problem der Exportgestaltung unterscheiden müssen.