Markdown Zeilenumbruch funktioniert nicht: Ursachen und Lösungen

VeröffentlichtToolMarkdown in HTML umwandeln

Inhalt
  1. Warum die Eingabetaste keinen Zeilenumbruch erzeugt
  2. So fügen Sie Zeilenumbrüche zuverlässig ein
  3. Typische Stolpersteine
  4. Fazit
  5. Häufige Fragen

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.

Markdown in HTML umwandeln

Kostenlos · ohne Anmeldung · Umwandlung nur im Browser (keine Übertragung an einen Server)

Typische Stolpersteine

SituationUrsache
Zeilen wurden mit der Eingabetaste getrennt, das Ergebnis steht aber in einer ZeileEin Soft Break wird standardmäßig als einzelnes Leerzeichen behandelt (CommonMark-Standardregel)
Zwei Leerzeichen am Zeilenende bewirken nichtsDer Editor oder Messenger entfernt Leerzeichen am Zeilenende beim Speichern bzw. Senden automatisch
In Tabellenzellen lässt sich keine Zeile umbrechenDie 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 erhaltenEin 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.

Markdown in HTML umwandeln

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

Ähnliche Artikel

  1. Markdown-Tabelle ausrichten: Der Doppelpunkt in der TrennzeileWarum Leerzeichen in Markdown-Tabellen nichts ausrichten: Die Doppelpunkte in der Trennzeile unter der Kopfzeile legen links, zentriert oder rechts fest.
  2. Markdown-Tabelle in CSV für Excel umwandeln – ohne FehlerWarum Markdown-Tabellen aus Notion oder GitHub in Excel zerfallen und wie Sie Trennzeile und maskierte Pipes bereinigen und als CSV korrekt übernehmen.
  3. Sitzungsprotokoll schreiben: Warum die Tagesordnung nicht reichtEin Protokoll nur mit Tagesordnung hilft später kaum. So trennen Sie Themen, Beschlüsse und Aufgaben und halten Verantwortliche und Fristen fest.
  4. Pressemitteilung schreiben: W-Fragen in Titel und Lead ordnenWie Sie in Titel und erstem Absatz die W-Fragen sinnvoll anordnen, welcher Fehler im Titel häufig vorkommt und wie der Lead Redakteure zum Weiterlesen bringt.
  5. Gliederung für Angebote: Aufbau je nach ProjektartWarum die Gliederung eines Angebots nicht frei wählbar ist, wie sie je nach Projektart aufgebaut ist und was gilt, wenn die Vorgaben des Auftraggebers abweichen.
  6. SQL INSERT in CSV umwandeln: NULL und leeren String trennenWie Sie beim Umwandeln von SQL INSERT in CSV NULL und leere Strings unterscheiden: Regeln für die manuelle Umsetzung und Prüfung des Ergebnisses.

Passende Tools