So fügst du in Markdown einen Zeilenumbruch ein:zwei Leerzeichen, ein Backslash oder ein br-Tag.

Du drückst in einer Markdown-Datei die Eingabetaste, und die beiden Zeilen erscheinen als eine. Das ist Absicht. Hier steht, warum das so ist und wie du einen Umbruch erzwingst.

macOS 14 oder neuer. Lesen ist kostenlos; Bearbeiten und Reviews kaufst du einmalig.

Kurze Antwort

Ein einzelner Zeilenumbruch gilt in Markdown als Leerzeichen, deshalb laufen die Zeilen zusammen. Um die Zeile umzubrechen, beende sie mit zwei Leerzeichen oder einem Backslash oder setze ein HTML-<br>-Tag ans Ende. Für einen neuen Absatz lässt du eine Leerzeile.

First line\
Second line, after a backslash

Next paragraph, after a blank line

·

Warum Markdown deinen Zeilenumbruch ignoriert

Markdown fügt die Zeilen eines Absatzes zusammen. Wenn du schreibst

Roses are red
Violets are blue

sieht der Leser einen Absatz, Roses are red Violets are blue. Der Zeilenumbruch im Quelltext ist ein weicher Umbruch: eine Stelle, an der du den Text umgebrochen hast, nicht eine, an der der Leser einen Umbruch sehen soll. So kannst du lange Zeilen in deinem Editor umbrechen, ohne die Darstellung der Seite zu ändern.

Eine Leerzeile ist etwas anderes. Sie beendet den Absatz und beginnt einen neuen, mit Abstand dazwischen. Meistens ist das der Umbruch, den du willst.

Drei Wege, einen Zeilenumbruch zu erzwingen

Ein erzwungener Zeilenumbruch, ein harter Umbruch, belässt den Text im selben Absatz und beginnt die nächste Zeile.

  1. Zwei Leerzeichen am Zeilenende

    Tippe mindestens zwei Leerzeichen, bevor du die Eingabetaste drückst. Das funktioniert überall, aber du siehst die Leerzeichen nicht, und manche Editoren und Git-Einstellungen entfernen sie.

  2. Ein Backslash am Zeilenende

    Setze \ als allerletztes Zeichen, ohne Leerzeichen danach. Er ist sichtbar und übersteht das Entfernen von Leerzeichen. Er gehört zu CommonMark und GitHub Flavored Markdown, auch wenn ein paar ältere Apps ihn nicht kennen.

  3. Ein HTML-br-Tag

    Beende die Zeile mit <br> (oder <br/>). Das funktioniert in fast jeder App, die Inline-HTML zulässt. Es ist auch der einzige Weg, in einer Tabellenzelle umzubrechen.

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

Alle drei liefern dasselbe Ergebnis:

Two spaces after this line
comes out on a new line.

Welchen solltest du nehmen?

  • Einen neuen Absatz (Leerzeile) für alles, was ein eigener Gedanke ist. Das ist die am besten übertragbare Wahl.
  • Einen Backslash, wenn du mitten im Absatz umbrechen willst, etwa bei einer Adresse oder einem Gedicht, und die App CommonMark folgt.
  • Ein br-Tag in einer Tabellenzelle oder wenn du nicht sicher bist, dass die App die anderen beiden unterstützt.
  • Zwei Leerzeichen nur, wenn du sicher bist, dass sie niemand entfernt.

Umbrüche funktionieren nicht innerhalb eines Code-Spans, und ein Umbruch ganz am Ende eines Absatzes bewirkt nichts. Willst du Leerraum, nimm eine Leerzeile oder eine Überschrift statt eines Haufens <br>-Tags.

Beispiele: eine Adresse, ein Gedicht, ein Listeneintrag

Ein harter Umbruch passt zu Text, bei dem die Zeile selbst zählt, etwa eine Postadresse:

Jane Smith221B Baker StreetLondon

Jane Smith
221B Baker Street
London

Beende in einem Listeneintrag die Zeile mit dem Umbruch und rücke die nächste Zeile so ein, dass sie auf den Text des Eintrags passt:

- Pack the bags  and lock the door
- Leave at eight

Braucht jede Zeile eines langen Textes einen Umbruch, ist der Text wahrscheinlich eine Liste oder ein Codeblock, und Markdown hat für beides eine Syntax.

Wenn der Zeilenumbruch trotzdem nicht funktioniert

  • Ein einzelnes Leerzeichen am Ende. Du brauchst zwei oder mehr.
  • Ein Leerzeichen nach dem Backslash. Der Backslash muss das letzte Zeichen der Zeile sein.
  • Der Editor entfernt Leerzeichen am Zeilenende beim Speichern. Wechsle zu einem Backslash oder einem br-Tag.
  • Derselbe Text sieht an zwei Stellen verschieden aus. Manche Apps, etwa die Eingabefelder für GitHub-Issues und -Kommentare, behalten einzelne Zeilenumbrüche als Umbrüche, eine Markdown-Datei auf GitHub dagegen nicht. Ein erzwungener Umbruch sieht in beiden gleich aus.
  • Text in einem Listeneintrag oder Zitat. Lass den Umbruch am Zeilenende und rücke die nächste Zeile passend zum Eintrag ein.

Am schnellsten prüfst du es, indem du die Datei in einem Reader öffnest. DotMD folgt diesen Regeln: Ein einzelner Zeilenumbruch verbindet die Zeilen, und zwei Leerzeichen, ein Backslash oder ein <br> brechen die Zeile um. Lesen ist kostenlos, und in DotMD Editor zeigt die Live-Vorschau das Ergebnis beim Tippen.

Fragen zu Zeilenumbrüchen in Markdown

Wie füge ich in Markdown eine neue Zeile ein?

Beende die Zeile mit zwei Leerzeichen, einem Backslash oder einem <br>-Tag, um innerhalb eines Absatzes umzubrechen. Lass eine Leerzeile, um einen neuen Absatz zu beginnen.

Warum wird meine neue Zeile in Markdown ignoriert?

Markdown behandelt einen einzelnen Zeilenumbruch als Leerzeichen, deshalb werden die Zeilen zu einem Absatz. Nimm eine Leerzeile, zwei Leerzeichen am Ende, einen Backslash oder <br> für einen sichtbaren Umbruch.

Funktionieren zwei Leerzeichen immer als Zeilenumbruch?

In CommonMark und GitHub Flavored Markdown ja. Editoren und Git-Werkzeuge entfernen Leerzeichen am Zeilenende aber oft, wodurch der Umbruch unbemerkt verschwindet. Ein Backslash oder <br> ist sicherer.

Wie füge ich in einer Markdown-Tabelle einen Zeilenumbruch ein?

Nimm <br> in der Zelle. Zwei Leerzeichen und ein Backslash funktionieren dort nicht, weil eine Tabellenzeile eine einzige Textzeile ist.

Weitere Fragen