Horizontale Linie in Markdown: Trennlinien, Regeln und häufige Lösungen

Für eine horizontale Linie in Markdown schreiben Sie drei Bindestriche in eine eigene Zeile und lassen darüber und darunter eine Leerzeile:

Ende des ersten Abschnitts.

---

Beginn des nächsten Abschnitts.

Das Ergebnis ist eine Trennlinie zwischen zwei Absätzen. Markdown nennt sie einen thematischen Umbruch; HTML stellt sie mit <hr> dar. Fügen Sie das Beispiel in den Markdown-Betrachter ein, um das gerenderte Dokument zu prüfen.

Drei Möglichkeiten für eine Trennlinie

Alle folgenden Formen erzeugen einen thematischen Umbruch:

Markdown-Quelltext	Ergebnis
---	Horizontale Trennlinie
***	Horizontale Trennlinie
___	Horizontale Trennlinie
* * *	Horizontale Trennlinie

Verwenden Sie mindestens drei gleiche Bindestriche, Sternchen oder Unterstriche. Leerzeichen zwischen den Zeichen sind erlaubt. Gemischte Zeichenarten, zusätzlicher Text in derselben Zeile oder nur zwei Zeichen erzeugen keine Trennlinie. Diese Syntaxregeln stammen aus der CommonMark-Spezifikation für thematische Umbrüche.

Die Anzahl der Bindestriche bestimmt nicht die sichtbare Breite. 20 Bindestriche und drei Bindestriche erzeugen dasselbe HTML-Element; dessen Aussehen wird durch die Formatierung am Ziel bestimmt.

Warum wurde meine horizontale Linie zur Überschrift?

Dieser Quelltext setzt keine Trennlinie unter „Versionshinweise“:

Versionshinweise
---

Er erzeugt eine Überschrift zweiter Ebene. Bindestriche direkt unter Absatztext können eine Setext-Überschrift bilden. Diese Interpretation hat Vorrang vor einer horizontalen Trennlinie. Trennen Sie beides durch eine Leerzeile:

Versionshinweise

---

Für einen Dokumentabschnitt ist eine ausdrücklich gekennzeichnete Überschrift oft klarer:

## Versionshinweise

Der Import unterstützt jetzt CSV-Dateien.

Beschriften Sie Abschnitte mit Markdown-Überschriften. Eine horizontale Trennlinie eignet sich, wenn der Übergang selbst wichtig ist, etwa zwischen einem Brief und einem Anhang.

Warum erscheint die Trennlinie als normaler Text?

Prüfen Sie den Quelltext rund um die Trennlinie:

Symptom	Wahrscheinliche Ursache	Lösung
Die Vorschau zeigt --- in einem Codeblock	Vier Leerzeichen am Anfang eines eigenständigen Blocks oder ein nicht geschlossener Codezaun	Einrückung entfernen oder Codezaun schließen
Die Vorschau zeigt --	Nur zwei Bindestriche	Mindestens drei verwenden
Neben den Zeichen steht Text	Die Zeile enthält zusätzlichen Text	Zeichen in eine eigene Zeile setzen
Innerhalb eines Satzes erscheint ---	Zeichen stehen in Backticks	Backticks entfernen, wenn eine Trennlinie gewünscht ist
Der vorherige Absatz wird zur Überschrift	Keine Leerzeile vor ---	Leerzeile einfügen

Auf der obersten Dokumentebene sind vor einem thematischen Umbruch bis zu drei Leerzeichen erlaubt. Innerhalb von Listen bestimmt die Einrückung außerdem, zu welchem Eintrag der Inhalt gehört. Prüfen Sie daher die umgebende Liste, statt alle Leerzeichen zu entfernen.

Eine horizontale Linie ist kein Zeilenumbruch

Eine Trennlinie trennt Abschnitte. Sie setzt die folgenden Wörter nicht bloß in eine neue Zeile.

Verwenden Sie für eine Adresse einen harten Zeilenumbruch:

120 Market Street\
San Francisco, CA

Für einen neuen Absatz lassen Sie eine Leerzeile. Für eine Abschnittstrennung verwenden Sie --- in einer eigenen Zeile. Der Leitfaden zu Markdown-Zeilenumbrüchen erklärt nachgestellte Leerzeichen, Backslashes und GitHubs unterschiedliches Verhalten bei Zeilenumbrüchen in Dateien und Kommentaren.

Eine Trennlinie innerhalb eines Blockzitats

Behalten Sie das Präfix > in jeder Zeile bei, auch bei der Trennlinie und den Leerzeilen:

> Ursprünglicher Vorschlag.
>
> ---
>
> Zusätzlicher Kontext aus der Prüfung.

Die Trennlinie bleibt innerhalb des Zitats. Entfernen Sie > vor der Linie, kann dies das Zitat beenden und die Linie in das äußere Dokument verschieben. Die Beispiele für Blockzitate behandeln mehrere Absätze und verschachtelte Zitate.

Ein Tabellentrenner ist keine horizontale Trennlinie

Diese Zeile gehört zu einer Tabelle:

| Format | Bearbeitbar |
| --- | :---: |
| Markdown | Ja |

Senkrechte Striche und optionale Doppelpunkte beschreiben die Spalten. Sie erzeugen keine seitenbreite Trennlinie. Erstellen Sie eine Tabelle mit dem Markdown-Tabellengenerator, oder verwenden Sie CSV in Markdown, wenn die Daten bereits in einer Tabellenkalkulation vorliegen.

Horizontale Trennlinien in exportierten Dokumenten

Ein thematischer Umbruch ist kein Befehl für einen Seitenumbruch. Ein PDF- oder Word-Export bestimmt die Seitenenden anhand seiner Layout- und Paginierungsregeln. Zusätzliche Bindestriche bewirken nicht, dass der nächste Abschnitt auf einer neuen Seite beginnt.

Bei einer Webseite, deren CSS Sie kontrollieren, lässt sich das erzeugte <hr> im Stylesheet der Website gestalten. Ein gehosteter Markdown-Dienst erlaubt möglicherweise kein eigenes CSS. Prüfen Sie das endgültige Ziel oder das exportierte Dokument, insbesondere wenn die Trennlinie eine Bedeutung trägt, die auch beim Drucken erhalten bleiben muss.

Häufig gestellte Fragen

Brauche ich Leerzeilen um eine horizontale Trennlinie?

CommonMark verlangt sie nicht in jedem Kontext. Sie vermeiden jedoch die häufige Mehrdeutigkeit von --- als Überschrift und machen Quelldateien leichter lesbar.

Kann ich ein HTML-Tag hr verwenden?

<hr> funktioniert in Renderern, die rohes HTML erlauben. Für ein Markdown-Dokument ist die Markdown-Syntax --- geeigneter. Der MD File Viewer-Editor entfernt vom Benutzer eingegebene HTML-Tags; die Markdown-Syntax für Trennlinien wird dagegen normal gerendert.

Wie zeige ich drei Bindestriche ohne Trennlinie an?

Schreiben Sie Syntaxbeispiele als Inline-Code: `---`. Für normalen Text in einer eigenen Zeile maskieren Sie den ersten Bindestrich: \---.

Für weitere gängige Formatierungen hilft der Markdown-Spickzettel.