Lists

You can organize items into ordered and unordered lists to make a list of items, for example, menu options, supported features, or numbered elements in a screenshot.

In Markdown, to create an ordered list, add items with numbers followed by periods. To create an unordered list, add dashes (-), asterisks (*), or plus signs (+) in front of items. Indent items to create a nested list. To add list attributes, put them in curly braces after an empty line.

In semantic markup, use a <list> tag to start a list and a <li> tag to specify list items.

First item.
1. First indented item.
2. Second indented item.
Second item.
Third item.
Fourth item.

Some list item
Another list item
Yet another list item
- Some indented item
- Another indented item
One more item

                
                    <list style="decimal" start="2">
                        <li>First item.
                        <list style="alpha-lower">
                            <li>First indented item.</li>
                            <li>Second indented item.</li>
                        </list>
                        </li>
                        <li>Second item.</li>
                        <li>Third item.</li>
                        <li>Fourth item.</li>
                    </list>

                    <list style="bullet">
                        <li>Some list item</li>
                        <li>Another list item</li>
                        <li>Yet another list item
                            <list style="bullet">
                                <li>Indented item</li>
                                <li>Indented item</li>
                            </list>
                        </li>
                        <li>One more item</li>
                    </list>
                
            

                1. First item.
                    1. First indented item.
                    2. Second indented item.

                    {style="alpha-lower"}
                2. Second item.
                3. Third item
                4. Fourth item

                {start="2"}

                - Some list item
                - Another list item
                - Yet another list item
                    - Some indented item
                    - Another indented item
                - One more item
            

The list has the following attributes:

style=[bullet|decimal|alpha-lower|none]

Specify the list type.

Mark list items with bullets when the order is not important.

Some list item
Another list item
Yet another list item

Mark list items with decimal digits (1, 2, 3, and so on) when the order or number of items is important.

First list item
Second list item
Third list item

Mark list items with letters (a, b, c, and so on). For example, if you need another sublevel for the nested list

First item
Second item
Third item

Do not render any markers for list items.

Some list item
Another list item
One more list item

start

Specify the starting position for a numbered list.

columns

Use to render the list items in multiple columns (make a horizontal list). Specify the number from 2 to 5.

sorted

Specify the sorting order for alphabetical and numeral lists.

id

Specify a unique identifier to use as a link anchor and generate a meaningful URL for this list. You can reference and reuse any element that has an ID.

filter

Define a set of custom filters for conditionally including this list.

instance

Define a set of instances for conditionally filtering this list.

switcher-key

Make this list switchable depending on the selected key.

Last modified: 21 August 2023