Zeilenumbrüche in Markdown: Neue Zeilen, Absätze und Tabellenzellen

Um innerhalb eines Markdown-Absatzes eine neue Zeile zu beginnen, setzen Sie einen Backslash ans Ende der ersten Zeile und drücken anschließend Enter. Für einen eigenen Absatz lassen Sie eine Zeile leer. Dabei entstehen unterschiedliche Dokumentstrukturen, was beim späteren Export einer README-Datei, einer Adresse oder eines Berichts nach Word eine Rolle spielt.

Dokumentationsteam\
Beispielstraße 42\
Portland, OR

Die Adresse bleibt ein einziger Absatz mit drei angezeigten Zeilen. Fügen Sie sie in die Markdown-Vorschau ein, um sie mit den folgenden Beispielen zu vergleichen.

Den passenden Umbruch auswählen

Ein Zeilenumbruch erzeugt keinen Seitenumbruch. Soll der nächste Abschnitt im exportierten Dokument auf einem neuen Blatt beginnen, lesen Sie die separate Anleitung zu Seitenumbrüchen in Markdown.

Warum Enter wie ein Leerzeichen aussehen kann

Probieren Sie diesen Quelltext aus:

Der Entwurf ist fertig.
Die prüfende Person kann ihn heute öffnen.

In der Vorschau dieser Website gehören beide Sätze zu einem Absatz und werden zusammenhängend angezeigt. Der Zeilenwechsel bleibt in der Quelldatei hilfreich, erzwingt im Browser aber keine neue sichtbare Zeile. Der Browser kann den Text weiterhin entsprechend der verfügbaren Breite umbrechen.

Fügen Sie nun eine Leerzeile ein:

Der Entwurf ist fertig.

Die prüfende Person kann ihn heute öffnen.

Die Vorschau erzeugt zwei Absätze. Nutzen Sie diese Variante, wenn mit dem zweiten Satz ein neuer Gedanke beginnt. Mehrere Leerzeilen sind kein zuverlässiges Mittel für zusätzlichen vertikalen Abstand; die Absatzgestaltung übernimmt der Renderer oder die Dokumentvorlage.

Backslash oder zwei Leerzeichen am Zeilenende

CommonMark definiert sowohl zwei Leerzeichen vor einem Zeilenwechsel als auch einen Backslash vor einem Zeilenwechsel als Syntax für einen harten Zeilenumbruch innerhalb eines Absatzes. Die CommonMark-Beispiele für harte Zeilenumbrüche dokumentieren beide Formen.

Die Variante mit Backslash ist bei der Prüfung einer Datei gut sichtbar:

Erstellt vom Dokumentationsteam\
Geprüft von der Release-Leitung

Alternativ geben Sie nach Dokumentationsteam genau zwei Leerzeichen ein und drücken dann Enter. Diese Leerzeichen sind in vielen Editoren unsichtbar und werden möglicherweise durch eine automatische Bereinigung von Leerzeichen am Zeilenende entfernt. Verschwindet ein Umbruch nach dem Speichern, prüfen Sie die Einstellungen für Leerraum oder verwenden Sie den Backslash.

Geben Sie im normalen Fließtext nicht die beiden Zeichen \n ein, um einen Umbruch zu erzeugen. Das ist eine Konvention für Zeichenketten in Programmiersprachen, kein Markdown-Zeilenwechsel. Vermeiden Sie außerdem einen Backslash ganz am Ende eines Absatzes: Auf einen harten Umbruch muss eine weitere Zeile mit Absatzinhalt folgen.

GitHub-Kommentare und README-Dateien verhalten sich unterschiedlich

GitHubs Dokumentation zu Zeilenumbrüchen unterscheidet .md-Dateien in Repositories von Issues, Pull Requests und Diskussionen. In diesen Gesprächsbereichen können gewöhnliche Zeilenwechsel als Umbrüche erscheinen, während eine README-Datei eine ausdrückliche Syntax für harte Umbrüche benötigt.

Deshalb kann aus einem Issue kopierter Text in einer README-Datei anders aussehen. Prüfen Sie die Zieldatei, statt anzunehmen, dass alle Bereiche derselben Website identische Formatierungsregeln verwenden.

Eine Fortsetzung innerhalb eines Listeneintrags halten

Rücken Sie die Fortsetzung so ein, dass sie mit dem Anfang des Eintragstextes übereinstimmt:

- Versionshinweise\
  Die Migrationsanleitung ergänzen.
- Installationsanleitung

Hier enthält der erste Eintrag zwei angezeigte Zeilen. Der zweite Eintrag bleibt eigenständig. Für einen eigenen Absatz innerhalb des ersten Eintrags verwenden Sie eine Leerzeile und behalten die Einrückung der Fortsetzung bei:

- Versionshinweise

  Die Migrationsanleitung und bekannte Probleme ergänzen.
- Installationsanleitung

Die Anleitung zur Einrückung behandelt nummerierte Listen, verschachtelte Aufzählungen und Code innerhalb eines Eintrags.

Eine neue Zeile in einer Markdown-Tabellenzelle einfügen

Eine GFM-Tabellenzeile gehört auf eine einzige Quelltextzeile. Enter innerhalb ihres Inhalts kann die Zeile aufteilen. In Renderern, die HTML-Zeilenumbrüche erlauben, verwenden Sie dieses Muster:

| Dokument | Verantwortliche |
| --- | --- |
| Versionshinweise | Verfasser<br>Prüfer |

Die Vorschau dieser Website unterstützt dieses Beispiel. Ein Zielsystem, das HTML entfernt, könnte den Umbruch löschen oder das Tag anzeigen. Prüfen Sie daher die Plattform, bevor Sie dieses Muster im gesamten Dokument einsetzen. Wenn eine Zelle mehrere Absätze benötigt, ist eine Liste außerhalb der Tabelle oft leichter zu pflegen.

Verwenden Sie den Markdown-Tabellengenerator für tabellarische Daten und die Anleitung zur Tabellensyntax für Ausrichtung und maskierte senkrechte Striche.

Das exportierte Dokument prüfen

Testen Sie vor der Nutzung des Markdown-zu-Word-Konverters ein kurzes Beispiel mit einem gewöhnlichen Zeilenwechsel, einem ausdrücklichen harten Umbruch und einer Leerzeile. Die Vorschau sollte entsprechend einen zusammenhängenden Absatz, einen erzwungenen Zeilenumbruch und zwei getrennte Absätze zeigen.

Öffnen Sie die heruntergeladene DOCX-Datei und prüfen Sie Adresse, Listen und Tabelle. Seitenbreite und Absatzformatvorlagen in Word können den Textfluss verändern, selbst wenn die zugrunde liegenden Umbrüche stimmen. Korrigieren Sie zuerst die Markdown-Struktur; passen Sie die endgültige Typografie in Word an, wenn eine bestimmte Dokumentvorlage dies erfordert.