Warum Markdown deine Zeilenumbrüche ignoriert – und wie du es behebst
Ein Zeilenumbruch, eine Leerzeile und ein Backslash erzeugen unterschiedliche Ergebnisse. Finde heraus, welches dein Dokument benötigt.
Du drückst in einem Markdown-Editor die Eingabetaste, aber die Vorschau lässt beide Sätze in einem Absatz. Meistens ist nichts kaputt: Ein einzelner Zeilenumbruch und ein neuer Absatz haben in Markdown unterschiedliche Bedeutungen.
Probiere dieses kleine Beispiel im Markdown-Editor aus:
Bring a notebook.
Bring a pen.
Meet at the front desk.
Bei deaktivierter Option Zeilenumbrüche beibehalten teilen sich die ersten beiden Sätze einen Absatz. Die Leerzeile beginnt einen neuen Absatz. Eine schmale Vorschau kann einen Satz trotzdem umbrechen; das ist die Seitenbreite, kein gespeicherter Zeilenumbruch.
Wähle den Umbruch, den du wirklich brauchst
Für einen neuen Absatz lasse eine Leerzeile. Für einen bewussten Umbruch innerhalb desselben Absatzes setze einen Backslash ans Ende der ersten Zeile:
Bring a notebook.\
Bring a pen.
Meet at the front desk.
CommonMarks Regeln für Zeilenumbrüche erlauben auch zwei Leerzeichen vor einem Zeilenumbruch. Ein Backslash ist beim Bearbeiten leichter zu erkennen und verschwindet weniger leicht, wenn nachfolgende Leerzeichen entfernt werden.
Verwende einen Absatzumbruch zwischen getrennten Gedanken. Verwende einen harten Zeilenumbruch für etwas wie eine kurze Adresse oder Zeilen, die innerhalb eines Blocks getrennt bleiben sollen. Füge nicht nach jeder Zeile harte Umbrüche ein, nur weil ein Texteditor sie so umgebrochen hat.
Zeilenumbrüche beim Einfügen beibehalten, wenn das beabsichtigt ist
In CozyToolkit öffne Optionen und aktiviere Zeilenumbrüche beibehalten. Ein einzelner Zeilenumbruch innerhalb eines Absatzes wird nun als sichtbarer Umbruch dargestellt. Die Einstellung ändert die gerenderte Vorschau und den HTML-Export; sie fügt keine Backslashes in den Markdown-Quelltext ein.
Das ist wichtig, wenn du den Quelltext an jemand anderen sendest. Markdown kopieren kopiert weiterhin den Originaltext. Ein anderer Editor kann diese einzelnen Zeilenumbrüche anders darstellen. Verwende explizite Backslashes, wenn andere Editoren den Umbruch an derselben Stelle anzeigen sollen, oder sende das gerenderte HTML.
Lade die Beispieldatei mit einfachen Zeilenumbrüchen und die Beispieldatei mit expliziten Umbrüchen herunter, um sie zu vergleichen. Auf dem Handy kannst du mit Schreiben und Vorschau zwischen Quelle und gerendertem Ergebnis wechseln.
Überprüfe das exportierte Dokument
Für unser Beispiel sind die Ergebnisse:
| Eingabe und Einstellung | Absätze | Explizite Umbrüche innerhalb von Absätzen |
|---|---|---|
| Einfache Zeilenumbrüche, Beibehalten aus | 2 | 0 |
| Einfache Zeilenumbrüche, Beibehalten an | 2 | 1 |
| Backslash vor Zeilenumbruch, Beibehalten aus | 2 | 1 |
Die Überschrift in der herunterladbaren Beispieldatei ist getrennt von diesen Absatzzahlen. Öffne die HTML-Versionen, um einfache Zeilenumbrüche, beibehaltene Zeilenumbrüche und einen expliziten Umbruch zu vergleichen.
Für ein PDF wähle Drucken / PDF und dann die Option „Als PDF speichern“ deines Browsers, falls verfügbar. Überprüfe die Druckvorschau: Papierformat, Ränder und Browser-Kopfzeilen können beeinflussen, wo Text umbricht. Ein Zeilenumbruch bedeutet keinen Seitenumbruch.
Was wir geprüft haben
Am 8. Oktober 2026 haben wir alle drei Versionen mit denselben Markdown-Parser-Einstellungen, demselben HTML-Sanitizer und demselben Dokument-Exporter wie das Tool gerendert. Jede erzeugte zwei Absätze; die letzten beiden enthielten ein HTML-Zeilenumbruch-Element. Die Ergebnisdatei dokumentiert das gerenderte HTML und Datei-Hashes.
Diese Prüfungen decken die Ausgabe dieses Editors ab. Eine Chat-App, Publishing-Plattform oder ein anderer Markdown-Parser kann andere Regeln verwenden. Prüfe die Vorschau in der Zielanwendung, bevor du ein Dokument sendest, bei dem die Zeilenaufteilung wichtig ist.