100 % privat — alles läuft in Ihrem Browser
Markdown Einrückung
Dieselben Leerzeichen bedeuten in Markdown drei verschiedene Dinge. Wechseln Sie zwischen verschachtelten Listen, eingerücktem Code und Absatzfortsetzung — jeder Fall von Markdown Einrückung rendert live.
MD Viewer-Team
- Fruit
- Apple
- Green apple
- Banana
- Apple
- Bread
Das Verhalten der Markdown Einrückung ist kontextabhängig: Dieselben führenden Leerzeichen können einen Absatz fortsetzen, einen Listenpunkt schachteln oder Text in einen Codeblock verwandeln — je nachdem, was davor kam. Das ist die Falle. Menschen rücken für visuelle Ausrichtung ein und wundern sich, wenn das Rendering kippt: Eine verschachtelte Liste erscheint, ein Absatz verbindet sich mit einem Codeblock, oder die Einrückung verschwindet lautlos. Der Spielplatz oben lässt Sie mit einem Klick zwischen allen drei Fällen von Markdown Einrückung wechseln und genau sehen, was sich ändert.
Drei Regeln lohnen die Verinnerlichung: Zwei oder drei Leerzeichen (unter einem Listenmarker ausgerichtet) schachteln Listeninhalt; vier Leerzeichen am Anfang eines neuen Blocks erzeugen einen eingerückten Codeblock; und führende Leerzeichen am Anfang eines normalen Absatzes werden schlicht ignoriert — bis zu drei —, weil es keine Absatz-Einrückung in Markdown gibt. Dazwischen liegt der Fortsetzungsfall, wo eine eingerückte Zeile nach einem Listenpunkt zu diesem Punkt gehört statt zum Dokument.
Diese Seite rendert jeden Fall mit derselben Engine, die Viewer, Editor und PDF-Export der Seite antreibt — was Sie hier lernen, gilt überall. Probieren Sie die Beispiele, bearbeiten Sie die Quellen und nutzen Sie die Erklärungen unten, um vorherzusagen, was eine Markdown Einrückung tun wird, bevor Sie sie in ein README committen.
Markdown Einrückung: Was aus den Leerzeichen wird
| Sie tippen | Was die Einrückung tut |
|---|---|
| - Punkt - Kind | 2 Leerzeichen schachteln einen Punkt unter seinen Elternpunkt |
| 1. Punkt 1. Kind | 3 Leerzeichen richten unter dem Markertext aus, um zu schachteln |
| Code hier | 4 Leerzeichen am Blockanfang erzeugen einen eingerückten Codeblock |
| Absatz mehr Text | Bis zu 3 führende Leerzeichen werden entfernt — keine Einrückung |
| - Punkt fortgesetzt | Ausgerichtete Einrückung fortsetzt den Absatz des Punkts |
Markdown Einrückung bewusst einsetzen
- 1
Listen schachteln: unter dem Text ausrichten
Eine Markdown Einrückung schachtelt, wenn sie unter dem ersten Zeichen des Elternpunkts liegt — zwei Leerzeichen bei -Markern, drei bei 1.-Markern. Testen Sie das Beispiel Verschachtelte Liste oben, bis die Ausrichtung zur zweiten Natur wird.
- 2
Codeblöcke: vier Leerzeichen, erst Leerzeile
Vier führende Leerzeichen nach einer Leerzeile kippen Markdown in den Code-Modus — die Einrückung bewahrt den Monospace-Text unverändert. Das Beispiel Eingerückter Code zeigt denselben Inhalt mit und ohne den Schalter.
- 3
Absätze: gar nicht einrücken
Führende Leerzeichen an einem Absatz (drei oder weniger) werden verworfen. Es gibt keine Absatz-Einrückung in der Sprache — Struktur kommt aus Leerzeilen, nicht aus Ausrichtung.
- 4
Fortsetzung: den Takt des Punkts halten
Lange Listenpunkte brechen schöner, wenn Fortsetzungszeilen dieselbe Markdown Einrückung tragen wie der Punkttext. Sie schließen sich im Rendering dem Punkt an, statt in einen Codeblock oder neuen Absatz zu driften.
Warum die Markdown Einrückung kontextabhängig ist (und wie man sie behält)
Markdown parst Dokumente als Blöcke, und jeder Blocktyp trägt seinen eigenen Einrückungsvertrag. Ein Listenblock lädt die ausgerichtete Markdown Einrückung zum Schachteln und Fortsetzen ein; ein Absatz duldet und verwirft sie; ein frischer Block, der vier Leerzeichen tief beginnt, gilt als vorformatierter Code — ein Erbe der E-Mail-Zitierkonventionen der Neunziger. Der Renderer fragt nie, was Sie meinten — er wendet den Vertrag des Blocks an, in dem Sie stehen.
Der praktische Merksatz lautet Zähle-bis-vier. Ein bis drei Leerzeichen nach einem Listenmarker: Schachtelung oder Fortsetzung. Vier Leerzeichen im freien Feld: Code. Vier Leerzeichen direkt unter einem Listenpunkt: eingerückter Code im Punkt — was die meisten überrascht und das Beispiel Eingerückter Code harmlos demonstriert. Im Zweifel verdienen Codezäune mit Backticks den Vorzug: Zäune sind eindeutig, überleben Kopieren-Einfügen und deklarieren eine Sprache fürs Highlighting.
Sobald die Markdown Einrückung klickt, hört Listenarchitektur auf, Rätselraten zu sein. Tiefes Schachteln wechselt in der Praxis zwei und vier Leerzeichen pro Ebene; die Seite Markdown nummerierte Liste legt Nummerierungsregeln auf dieselben Ausrichtungsregeln. Beide Seiten teilen die Live-Engine dieser Seite — hier geprüftes Verhalten ist dort verlässliches Verhalten.
Fehler bei der Markdown Einrückung
1. Parent 1. Kind (2 Leerzeichen)
1. Parent 1. Kind (3 Leerzeichen)
Zwei Leerzeichen räumen den dreistelligen 1.-Marker nicht ab, das Kind verschmilzt mit der Elternzeile. Die Markdown Einrückung muss unter den Text ausgerichtet sein.
Absatz eingerückte Zeile
Absatz gezäunter oder eingerückter Code
Vier Leerzeichen direkt nach einem Absatz setzen ihn als Klartext fort — dieselben vier Leerzeichen nach einer Leerzeile werden zum Codeblock. Die Leerzeile ist der Schalter.
Führende Leerzeichen am Absatz
Keine führenden Leerzeichen
Absatzeinrückung existiert nicht: Markdown entfernt bis zu drei führende Leerzeichen beim Rendern. Organisieren Sie Prosa mit Blockstruktur, nicht mit Ausrichtung.
Einrückung überlebt ins PDF
Verschachtelte Listen behalten ihre Einrückungsebenen und eingerückter Code seinen Monospace-Block durch Markdown in PDF umwandeln — der Export durchwandert dieselbe Struktur, die die Vorschau rendert: Eine hier geprüfte Markdown Einrückung druckt sich genauso.
Häufige Fragen
Quellen und Spec-Zitate
“An indented code block is composed of one or more indented chunks separated by blank lines.”
“The contents of the code block are the literal contents of the lines, including trailing line endings, minus these four spaces of indentation.”