AsciiDoc User Guide

b. Vivamus fringilla mi eu lacus.

3.Donec eget arcu bibendum nunc consequat lobortis.

See also Admonition Icons and Captions.

Lists

List types

•Bulleted lists. Also known as itemized or unordered lists.

•Numbered lists. Also called ordered lists.

•Labeled lists. Sometimes called variable or definition lists.

•Callout lists (a list of callout annotations).

List behavior

•Indentation is optional and does not determine nesting, indentation does however make the source more readable.

•A nested list must use a different syntax from its parent so that asciidoc(1) can distinguish the start of a nested list.

•By default lists of the same type can only be nested two deep; this could be increased by defining new list definitions.

•In addition to nested lists a list item will include immediately following Literal paragraphs.

•Use List Item Continuation to include other block elements in a list item.

Bulleted and Numbered Lists

Bulleted list items start with a dash or an asterisk followed by a space or tab character. Bulleted list syntaxes are:

- List item. * List item.

Numbered list items start with an optional number or letter followed by a period followed by a space or tab character. List numbering is optional. Numbered list syntaxes are:

24

AsciiDoc User Guide

. Integer numbered list item.

1. Integer numbered list item with optional numbering.

.. Lowercase letter numbered list item.

a. Lowercase letter numbered list item with optional numbering.

Here are some examples:

-Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

*Fusce euismod commodo velit.

*Qui in magna commodo, est labitur dolorum an. Est ne magna primis adolescens. Sit munere ponderum dignissim et. Minim luptatum et vel.

*Vivamus fringilla mi eu lacus.

*Donec eget arcu bibendum nunc consequat lobortis.

-Nulla porttitor vulputate libero.

. Fusce euismod commodo velit.

. Vivamus fringilla mi eu lacus.

.. Fusce euismod commodo velit.

.. Vivamus fringilla mi eu lacus.

. Donec eget arcu bibendum nunc consequat lobortis.

-Praesent eget purus quis magna eleifend eleifend. 1. Fusce euismod commodo velit.

a.Fusce euismod commodo velit.

b.Vivamus fringilla mi eu lacus.

c.Donec eget arcu bibendum nunc consequat lobortis.

2.Vivamus fringilla mi eu lacus.

3.Donec eget arcu bibendum nunc consequat lobortis.

4.Nam fermentum mattis ante.

Which render as:

•Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

•Fusce euismod commodo velit.

•Qui in magna commodo, est labitur dolorum an. Est ne magna primis adolescens. Sit munere ponderum dignissim et. Minim luptatum et vel.

•Vivamus fringilla mi eu lacus.

•Donec eget arcu bibendum nunc consequat lobortis.

•Nulla porttitor vulputate libero.

1.Fusce euismod commodo velit.

2.Vivamus fringilla mi eu lacus.

a.Fusce euismod commodo velit.

b.Vivamus fringilla mi eu lacus.

3.Donec eget arcu bibendum nunc consequat lobortis.

•Praesent eget purus quis magna eleifend eleifend.

1.Fusce euismod commodo velit.

25

AsciiDoc User Guide

a.Fusce euismod commodo velit.

b.Vivamus fringilla mi eu lacus.

c.Donec eget arcu bibendum nunc consequat lobortis.

2.Vivamus fringilla mi eu lacus.

3.Donec eget arcu bibendum nunc consequat lobortis.

4.Nam fermentum mattis ante.

Vertical Labeled Lists

Labeled list items consist of one or more text labels followed the text of the list item.

An item label begins a line with an alphanumeric character hard against the left margin and ends with a double colon :: or semi-colon ;;.

The list item text consists of one or more lines of text starting on the line immediately following the label and can be followed by nested List or ListParagraph elements. Item text can be optionally indented.

Here are some examples:

Lorem::

Fusce euismod commodo velit.

Fusce euismod commodo velit.

Ipsum::

Vivamus fringilla mi eu lacus.

*Vivamus fringilla mi eu lacus.

*Donec eget arcu bibendum nunc consequat lobortis. Dolor::

Donec eget arcu bibendum nunc consequat lobortis. 'Suspendisse';;

A massa id sem aliquam auctor. 'Morbi';;

Pretium nulla vel lorem. 'In';;

Dictum mauris in urna.

Which render as:

Lorem

Fusce euismod commodo velit.

Fusce euismod commodo velit.

Ipsum

Vivamus fringilla mi eu lacus.

•Vivamus fringilla mi eu lacus.

26

AsciiDoc User Guide

•Donec eget arcu bibendum nunc consequat lobortis.

Dolor

Donec eget arcu bibendum nunc consequat lobortis.

Suspendisse

A massa id sem aliquam auctor.

Morbi

Pretium nulla vel lorem.

In

Dictum mauris in urna.

Horizontal Labeled Lists

Horizontal labeled lists differ from vertical labeled lists in that the label and the list item sit side-by-side as opposed to the item under the label. Item text must begin on the same line as the label.

Here are some examples:

*Lorem*:: Fusce euismod commodo velit.

Qui in magna commodo, est labitur dolorum an. Est ne magna primis adolescens.

Fusce euismod commodo velit.

*Ipsum*:: Vivamus fringilla mi eu lacus.

*Vivamus fringilla mi eu lacus.

*Donec eget arcu bibendum nunc consequat lobortis. *Dolor*:: Donec eget arcu bibendum nunc consequat lobortis.

Sit munere ponderum dignissim et. Minim luptatum et vel.

27