Trennlinien in Markdown

Drei oder mehr Bindestriche auf einer eigenen Zeile zeichnen eine Trennlinie. Es ist das einfachste Element in Markdown, und es verbirgt die übelste Überraschung des Formats: Setz dieselben Bindestriche direkt unter einen Absatz und du bekommst keinen Trenner, sondern eine Überschrift.

Etwas Text darüber.

---

Etwas Text darunter.

***

___

Auf diesen Absatz folgen Bindestriche
---

Sieh dir den letzten in der Vorschau an. Die Bindestriche haben aus der Zeile darüber eine <h2> gemacht.

Die drei Zeichen

Bindestriche, Sternchen oder Unterstriche — drei oder mehr, auf einer eigenen Zeile:

---
***
___

Alle drei ergeben dasselbe <hr>. Leerzeichen zwischen den Zeichen sind erlaubt, - - - funktioniert also auch, es gibt nur keinen Grund, es so zu schreiben.

--- ist die übliche Wahl und das, was jeder Editor einfügt.

Die Leerzeilenfalle

Sie ist der ganze Grund, aus dem es diese Seite gibt:

Ein Absatz.
---

Wenn sich ein Trenner in deinem Dokument immer wieder in eine Überschrift verwandelt, ist das der Grund. Sternchen kennen diese Mehrdeutigkeit nicht, und das ist das eine Argument für ***.

Front Matter nutzt dieselben Zeichen

Generatoren für statische Seiten setzen Metadaten zwischen zwei Zeilen aus Bindestrichen an den Anfang einer Datei:

---
title: Meine Seite
---

Hier beginnt der Inhalt.

Dieser Block ist überhaupt kein Markdown — es ist YAML, das das Werkzeug behandelt, bevor der Markdown-Parser die Datei je sieht. Es gilt nur dann als Front Matter, wenn es das Allererste im Dokument ist. Ein --- weiter unten ist eine gewöhnliche Trennlinie.

Jede Anleitung auf dieser Website beginnt mit genau so einem Block.

Wann man eine setzt

Sparsam. Eine Trennlinie ist ein starker visueller Bruch, und Überschriften drücken Struktur meist besser aus. Die Fälle, in denen eine Linie ihren Platz wirklich verdient:

• den Hauptteil eines Dokuments von Fußnoten oder einem Anhang trennen
• einen Szenenwechsel in einer Erzählung markieren, wo eine Überschrift falsch wäre
• Folien teilen, in Werkzeugen, die aus Markdown eine Präsentation machen — viele nutzen --- als Seitenumbruch

Häufige Fehler

Keine Leerzeile darüber. Du bekommst eine <h2> statt einer Linie. Die häufigste Markdown-Überraschung nach den Zeilenumbrüchen.

Weniger als drei Zeichen. -- ist nichts; --- ist eine Linie.

Zeichen mischen. -*- funktioniert nicht. Alle drei müssen gleich sein.

Eine Linie statt einer Überschrift. Wenn die Abschnitte Namen brauchen, gib ihnen Überschriften. Eine Linie sagt der lesenden Person, dass sich etwas geändert hat, aber nicht was.

Erwarten, sie gestalten zu können. Markdown hat keine Syntax für Dicke, Farbe oder Breite. Das ist CSS.

Häufige Fragen

Wie füge ich in Markdown eine waagerechte Linie ein?

Setz drei oder mehr Bindestriche, Sternchen oder Unterstriche auf eine eigene Zeile, mit einer Leerzeile darüber: ---.

Warum werden meine Bindestriche zu einer Überschrift?

Weil eine Zeile aus Bindestrichen direkt unter einem Absatz die alte Setext-Syntax für eine <h2> ist, die eine Überschrift unterstreicht statt ihr etwas voranzustellen. Lass eine Leerzeile zwischen Absatz und Bindestrichen und du bekommst stattdessen eine Linie.

Was ist der Unterschied zwischen ---, *** und ___?

In der Ausgabe keiner — alle drei ergeben dieselbe Trennlinie. --- ist üblich; *** hat den Vorteil, nie mit einer Setext-Überschrift verwechselt zu werden.

Was ist der ----Block am Anfang einer Markdown-Datei?

Front Matter: ein Block YAML-Metadaten — Titel, Datum, Schlagwörter —, den der Seitengenerator liest und vor dem Rendern entfernt. Er gilt nur ganz oben in der Datei als Front Matter.

Kann ich das Aussehen einer Trennlinie ändern?

Nicht in Markdown. Dicke, Farbe und Breite sind Sache des Stylesheets; Markdown sagt nur, dass hier eine Trennung ist. In einem Editor mit Vorschaustilen bestimmt der gewählte Stil, wie sie aussieht.