Insert ordered and unordered Lists into your Documents
Lists can appear in various forms:
Unordered lists have no clear sequence. They can be created in AsciiDoc and adoc Studio using either * or -. By pressing the Enter key, another key point can be added directly to the list. If you now press Enter again without entering text in the new key point, the list is closed.
Ordered lists are numbered and have a clear hierarchy or sequence. They can be created directly via the number by entering 1., 2., ... . However, this numbering is retained even if you change the order. We therefore recommend that you write ordered lists with . instead of a specific number.
This means that the numbering is adjusted dynamically, even if you change the order of individual list items.
Description lists let you pair an expression with an explanation. The syntax is always the same: expression:: description
By default, this creates a vertical description list. Each entry gets its own line, and the description appears beneath the expression. This layout is ideal when descriptions are longer or when you want more visual separation between items:
You can switch the layout to a horizontal description list by adding the [horizontal] block attribute directly above the list: