Listen in Markdown

Listen sind nach den Überschriften das meistgenutzte Stück Markdown — und dasjenige, bei dem die Einrückung stillschweigend entscheidet, ob du bekommst, was du meintest. Die Syntax ist ein Bindestrich oder eine Zahl; alles Interessante passiert im Leerraum.

Probier, einen Punkt einzurücken, die nummerierte Liste umzunummerieren oder einen Absatz in einen Punkt zu mischen:

- Erster Punkt
- Zweiter Punkt
  - Eine Ebene tiefer
  - Und noch einer
    - Zwei Ebenen tief
- Dritter Punkt

1. Schritt eins
1. Schritt zwei
1. Schritt drei

Aufzählungen

Beginn eine Zeile mit -, * oder +, gefolgt von einem Leerzeichen. Alle drei erzeugen dieselbe Ausgabe.

Such dir eines aus und wechsle es innerhalb eines Dokuments nie: Mitten in einer Liste das Zeichen zu tauschen ist der Weg, versehentlich eine zweite Liste direkt unter der ersten zu beginnen. - ist die häufigste Wahl und am leichtesten zu tippen.

Nummerierte Listen

Eine Zahl, ein Punkt, ein Leerzeichen. Und jetzt das, was sich zu wissen lohnt:

1. Den Reis waschen
1. Das Wasser dazugeben
1. Aufkochen lassen

Das erscheint als 1, 2, 3. Die Zahlen in der Quelle spielen keine Rolle — nur die erste legt den Startpunkt fest. Auf jeder Zeile 1. zu schreiben heißt, dass du Schritte umsortieren, einfügen und löschen kannst, ohne von Hand neu zu nummerieren. Das ist die nützlichste Gewohnheit in dieser ganzen Anleitung.

Soll eine Liste bei 5 beginnen, schreib 5. beim ersten Punkt und 1. beim Rest.

Verschachteln

Rück um zwei Leerzeichen ein, um unter den Punkt darüber zu rutschen. Manche Parser nehmen vier, manche drei; zwei funktionieren überall und sind das, was jeder moderne Editor erzeugt.

- Obst
  - Apfel
  - Birne
- Gemüse
  - Karotte
    - Nantaise
    - Chantenay

Du kannst nummerierte Listen unter Aufzählungen schachteln und umgekehrt — das Zeichen jeder Ebene ist unabhängig.

Enge und lockere Listen

Hier stolpern alle. Eine Leerzeile zwischen den Punkten ändert die Darstellung:

- Enge Liste
- Die Punkte stehen dicht beieinander

- Lockere Liste

- Jeder Punkt wird ein eigener Absatz

Ohne Leerzeilen bekommst du eine enge Liste, in der jeder Punkt nackter Text ist. Mit Leerzeilen bekommst du eine lockere Liste, in der jeder Punkt in ein <p> gepackt wird und die Abstände aufgehen. Beides ist gültig; der Fehler ist, das eine zu bekommen, wenn man das andere wollte. Wirkt eine Liste plötzlich zu luftig, steckt eine verirrte Leerzeile darin.

Absätze und Code in einem Punkt

Um einen zweiten Absatz, einen Codeblock oder ein Zitat in einen Listenpunkt zu setzen, rück es so ein, dass es mit dem Text des Punktes fluchtet — nicht mit seinem Zeichen:

1. Die App installieren

   Sie ist gratis, und die Gratisstufe hat kein Zeitlimit.

2. Ein Dokument öffnen

   ```
   # Meine erste Überschrift
   ```

3. Es exportieren

Die Fortsetzung ist hier um drei Leerzeichen eingerückt, weil 1. drei Zeichen breit ist. Unter einem - wären es zwei.

Häufige Fehler

Keine Leerzeile vor der Liste. Eine Liste, die direkt auf einen Absatz folgt, wird von vielen Parsern in ihn hineingezogen. Lass eine Leerzeile darüber.

Das Leerzeichen nach dem Zeichen fehlt. -Punkt ist keine Liste, sondern ein Absatz, der mit einem Bindestrich beginnt. - Punkt ist eine Liste.

Einrückung um ein Leerzeichen. Eines reicht zum Verschachteln nicht; der Punkt bleibt auf der obersten Ebene. Nimm zwei.

Zeichen mischen. Auf - Punkt ein * Punkt folgen zu lassen kann eine neue Liste beginnen statt die alte fortzusetzen. Bleib konsequent.

Von Hand umnummerieren. Schreib überall 1. und lass den Renderer zählen.

Häufige Fragen

Wie mache ich eine verschachtelte Liste in Markdown?

Rück den verschachtelten Punkt um zwei Leerzeichen gegenüber seinem Elternpunkt ein und nimm dann wie gewohnt ein Listenzeichen. Jede weiteren zwei Leerzeichen ergeben eine Ebene. Manche Parser nehmen auch vier Leerzeichen, aber zwei versteht jeder.

Warum wird meine Markdown-Liste nicht dargestellt?

Die beiden üblichen Ursachen sind ein fehlendes Leerzeichen nach dem Zeichen — -Punkt statt - Punkt — und eine fehlende Leerzeile zwischen dem vorangehenden Absatz und dem ersten Listenpunkt. In beiden Fällen liest der Parser die Zeilen als gewöhnlichen Text.

Müssen die Zahlen einer nummerierten Liste stimmen?

Nein. Nur die erste Zahl zählt, und sie legt fest, wo die Liste beginnt. Auf jeder Zeile 1. zu schreiben erscheint als 1, 2, 3 und macht das Umsortieren schmerzlos.

Was ist der Unterschied zwischen einer engen und einer lockeren Liste?

Eine enge Liste hat keine Leerzeilen zwischen den Punkten und setzt jeden Punkt als nackten Text. Eine lockere Liste hat Leerzeilen und packt jeden Punkt in einen Absatz, was vertikalen Abstand hinzufügt. Die Leerzeilen sind der einzige Unterschied.

Kann ich einen Codeblock in einen Listenpunkt setzen?

Ja. Rück den eingezäunten Block so ein, dass er mit dem Text des Punktes fluchtet und nicht mit seinem Zeichen — zwei Leerzeichen unter einem Aufzählungspunkt, drei unter 1.. Alles, was so weit eingerückt ist, gehört zu dem Punkt.