Markdown Zeilenumbruch funktioniert nicht: Ursachen und Lösungen

Inhalt
Wenn Sie in einem Markdown-Editor einmal die Eingabetaste drücken, um eine Zeile umzubrechen, kann es passieren, dass dieser Zeilenumbruch im konvertierten Ergebnis verschwindet und der Text in einer einzigen Zeile steht. Das ist kein Fehler, sondern das im Markdown-Standard (CommonMark) festgelegte Verhalten. Dieser Beitrag zeigt, wann Zeilenumbrüche verloren gehen und wie Sie Zeilen zuverlässig umbrechen.
Zusammenfassung ① Innerhalb eines Markdown-Absatzes wird ein einzelner Zeilenumbruch mit der Eingabetaste (Soft Break) standardmäßig nicht als Zeilenumbruch, sondern als einzelnes Leerzeichen behandelt. ② Für einen sicheren Zeilenumbruch trennen Sie Absätze mit einer Leerzeile, setzen am Zeilenende zwei Leerzeichen oder nutzen einen Konverter, bei dem die Option „breaks“ aktiviert ist. ③ Ob im konvertierten HTML ein
<br>-Tag steht, zeigt Ihnen, welche Variante angewendet wurde.
Warum die Eingabetaste keinen Zeilenumbruch erzeugt
Wer in einem Notizprogramm oder Markdown-Editor einen Hinweistext schreibt, trennt die Punkte oft nur mit der Eingabetaste voneinander. Zum Beispiel stehen Veranstaltungsdatum, Ort und Kontakt jeweils in einer eigenen Zeile.
Wandeln Sie diesen Text in HTML um und veröffentlichen ihn in einem Blog oder Forum, werden die einzeln geschriebenen Zeilen zu einem einzigen Satz zusammengezogen, nur durch je ein Leerzeichen getrennt. Obwohl Sie die Eingabetaste gedrückt haben, scheint der Zeilenumbruch nicht übernommen worden zu sein.
Das liegt nicht an einem defekten Editor oder Konverter. Markdown ist von Grund auf so ausgelegt, dass ein einzelner Zeilenumbruch innerhalb eines Absatzes nicht als Zeilenumbruch gilt.
So fügen Sie Zeilenumbrüche zuverlässig ein
Im Markdown-Standard (CommonMark) wird ein Absatz aus mehreren Textzeilen zu einer Einheit zusammengefasst und gemeinsam dargestellt. Ein einzelner Zeilenumbruch darin (Soft Break) wird nicht zum Zeilenumbruch, sondern zu einem einzelnen Leerzeichen.
Es gibt drei Möglichkeiten, einen Zeilenumbruch sicher einzufügen. Erstens: Fügen Sie zwischen den Zeilen eine Leerzeile ein, sodass ein eigener Absatz (<p>) entsteht. Zweitens: Lassen Sie am Zeilenende zwei Leerzeichen stehen, dann wird nur diese Zeile zu einem harten Umbruch (Hard Break, <br>).
Drittens: Bei Bildschirmen wie Chatfenstern oder Kommentarfeldern, in denen schon ein einzelner Druck auf die Eingabetaste die Zeile umbricht, ist die Erweiterungsoption „breaks“ des Konverters aktiviert. Ist diese Option eingeschaltet, wird jeder Zeilenumbruch innerhalb eines Absatzes in ein <br> umgewandelt.
Welche Variante tatsächlich angewendet wurde, erkennen Sie, indem Sie den konvertierten HTML-Code öffnen und prüfen, ob zwischen den Zeilen ein <br>-Tag steht.
Mit unserem Tool prüfen. Sie müssen nicht von Hand Leerzeilen einfügen oder Leerzeichen abzählen: Wie Ihr Text umgebrochen wird, sehen Sie direkt in der Vorschau und im HTML-Code. Bei diesem Konverter ist die Option „breaks“ aktiviert, sodass bereits ein einzelner Druck auf die Eingabetaste innerhalb eines Absatzes sofort als <br> übernommen wird.
Kostenlos · ohne Anmeldung · Umwandlung nur im Browser (keine Übertragung an einen Server)

Typische Stolpersteine
| Situation | Ursache |
|---|---|
| Zeilen wurden mit der Eingabetaste getrennt, das Ergebnis steht aber in einer Zeile | Ein Soft Break wird standardmäßig als einzelnes Leerzeichen behandelt (CommonMark-Standardregel) |
| Zwei Leerzeichen am Zeilenende bewirken nichts | Der Editor oder Messenger entfernt Leerzeichen am Zeilenende beim Speichern bzw. Senden automatisch |
| In Tabellenzellen lässt sich keine Zeile umbrechen | Die Tabellensyntax liest eine Zeile als eine einzige Textzeile, ein Zeilenumbruch in der Zelle ist daher gar nicht möglich |
| Zeilenumbrüche in Codeblöcken bleiben erhalten | Ein Codeblock ist ein Bereich, in dem der Originaltext unverändert bleibt, daher gilt die Soft-Break-Regel dort nicht |
Fazit
Nach der Standardregel wird ein einzelner Zeilenumbruch in einem Markdown-Absatz nicht als Zeilenumbruch, sondern als einzelnes Leerzeichen behandelt. Für einen sicheren Umbruch trennen Sie Absätze mit einer Leerzeile, setzen zwei Leerzeichen ans Zeilenende oder nutzen einen Konverter mit aktivierter Option „breaks“.
Da derselbe Text je nach Konverter-Einstellung unterschiedlich ausgegeben wird, ist der Blick auf das konvertierte HTML der zuverlässigste Weg: Prüfen Sie, ob ein <br>-Tag vorhanden ist.
Kostenlos · ohne Anmeldung · Umwandlung nur im Browser (keine Übertragung an einen Server)
Häufige Fragen
Wie erzwinge ich in Markdown einen Zeilenumbruch?
Am sichersten ist eine Leerzeile, die einen eigenen Absatz erzeugt. Wenn der Absatz bestehen bleiben und nur die Zeile umbrechen soll, lassen Sie am Zeilenende zwei Leerzeichen stehen. Viele Editoren entfernen diese Leerzeichen jedoch beim Speichern, daher sollten Sie das Ergebnis besser selbst kontrollieren.
Was ist der Unterschied zwischen einem Konverter mit und ohne „breaks“-Option?
Ist die Option „breaks“ aktiviert, wird schon ein einzelner Zeilenumbruch innerhalb eines Absatzes sofort zu einem <br>-Tag. Ist sie deaktiviert, wird nach der CommonMark-Standardregel ein einzelner Zeilenumbruch zu einem Leerzeichen zusammengezogen, und ein neuer Absatz entsteht erst durch eine Leerzeile.
Warum kann ich in einer Tabellenzelle keinen Zeilenumbruch einfügen?
Die Markdown-Tabellensyntax liest eine mit | getrennte Zeile als eine einzige Textzeile. Enthielte diese Zeile ein echtes Zeilenumbruchzeichen, würde die Tabellenstruktur zerbrechen. Für einen Umbruch in der Zelle müssen Sie daher das HTML-Tag <br> direkt schreiben.
Gehen Zeilenumbrüche in Codeblöcken auch verloren?
Nein. Ein Codeblock (der Bereich zwischen drei Backticks) ist ein Bereich, in dem der Originaltext unverändert erhalten bleibt. Die Soft-Break-Regel gilt dort nicht, und Ihre Zeilenumbrüche bleiben bestehen.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen