Lists

Lists can be a powerful tool for organizing information and presenting it in a clear and concise manner in your documentation page. Markdown provides support for both unordered and ordered lists, as well as nested lists. Let's dive into the details of how to use lists effectively in Markdown!

Unordered Lists

You can create unordered lists in Markdown using asterisks (*), plus signs (+), or hyphens (-) at the beginning of a line, followed by a space and the list item.

* First item
* Second item
* Third item
or
* First item
+ Second item
- Third item

To nest one list within another, you can indent each item in the sublist by two spaces or one tab. You can also nest other elements like paragraphs, blockquotes, or code blocks.

Nested Unordered Lists

* First item
    * First SubItem
        * First SubSubItem

Ordered Lists

In Markdown, you can create ordered lists using numbers followed by periods at the beginning of a line, followed by a space and the list item.

You don't have to use sequential numbers (1, 2, 3, etc.). Even single numbers followed by a period will render as an ordered list. If you use a number like 5, the list will start with 5.

If you want to display a literal period followed by a space, you can use a backslash (\) to escape the formatting.

1. First item
1. Second item
1. Third item
or
1. First item
2. Second item
3. Third item

You can also create nested ordered lists by indenting one or more list items under another item. Markdown allows you to mix ordered and unordered lists, and you can include other Markdown elements like links, images, and code blocks within your lists.

Nested Ordered Lists

1. First item
    1. First SubItem
        1. First SubSubItem