Listen

Die drei Listentypen

Listen können in verschiedenen Formen auftreten:

Ungeordnete Listen haben keine eindeutige Reihenfolge. Sie können in AsciiDoc entweder über * oder - erstellt werden. Durch Drücken der Enter-Taste kann direkt ein weiterer Stichpunkt hinzugefügt werden. Wenn Sie im neuen Stichpunkt ohne Text erneut Enter drücken, wird die Liste geschlossen.

description list

Geordnete Listen sind nummeriert und haben eine klare Reihenfolge. Sie können direkt über die Zahl erstellt werden, indem Sie 1., 2., …​ eingeben. Diese Nummerierung bleibt jedoch statisch, auch wenn Sie die Reihenfolge ändern. Daher empfehlen wir, geordnete Listen mit . zu schreiben.

structured list

Dadurch wird die Nummerierung dynamisch angepasst, selbst wenn Sie die Reihenfolge einzelner Listenpunkte ändern.

Beschreibungslisten verknüpfen einen Ausdruck mit einer Erklärung. Die Syntax ist: `Begriff

Beschreibung`.

Standardmäßig entsteht daraus eine vertikale Beschreibungsliste. Jeder Eintrag steht in einer eigenen Zeile, und die Erklärung erscheint unter dem Ausdruck. Sie können das Layout zu einer horizontalen Beschreibungsliste wechseln, indem Sie das Block-Attribut [horizontal] direkt oberhalb der Liste einfügen.

unstructured list

Verschachtelte Listen

Listen können beliebig tief verschachtelt werden. Fügen Sie einfach weitere Zeichen hinzu:

* Ebene 1
** Ebene 2
*** Ebene 3

Das Ergebnis:

  • Ebene 1

    • Ebene 2

      • Ebene 3

Bei geordneten Listen funktioniert es genauso mit zusätzlichen Punkten:

. Erster Punkt
.. Unterpunkt a
.. Unterpunkt b
. Zweiter Punkt

Checklisten

Für Aufgabenlisten können Sie Checklisten verwenden:

* [x] Erledigt
* [ ] Noch offen
* [x] Auch erledigt

Das Ergebnis:

  • Erledigt

  • Noch offen

  • Auch erledigt

Wenn Sie komplexe Inhalte wie Absätze oder Code-Blöcke in einem Listenpunkt benötigen, verwenden Sie das +-Zeichen auf einer eigenen Zeile, um den Inhalt anzuhängen. 
* Erster Punkt
+
Dieser Absatz gehört noch zum ersten Punkt.
+
Und dieser auch.
* Zweiter Punkt

Das Ergebnis:

  • Erster Punkt

    Dieser Absatz gehört noch zum ersten Punkt.

    Und dieser auch.

  • Zweiter Punkt