Markdown Guide — Part 4: Markdown List Syntax
1. Unordered Lists
Unordered lists are typically used to present items without any specific order.
You can use -, +, or * at the beginning of a line to create an unordered list — all of them render identically.
It’s recommended to choose one symbol (for example, -) and use it consistently across the team to maintain a uniform document style.
Example:
- Apple
- Banana
- Orange
Rendered Output:
- Apple
- Banana
- Orange
Best Practices:
- Always include a space after the list marker.
- Keep the symbol consistent throughout the document.
- To create a line break, add two spaces at the end of a line and press Enter.
2. Ordered Lists
Ordered lists are used to describe steps or processes that follow a specific sequence.
Simply add a number followed by a period (.) before each line.
Example:
1. Prepare ingredients
2. Heat the pan
3. Start cooking
Rendered Output:
- Prepare ingredients
- Heat the pan
- Start cooking
Note:
When rendered in Markdown, the numbers do not have to be in sequential order (e.g., 1., 2., 3.).
However, for clarity and readability, it’s best to keep the numbering consistent.
3. Nested Lists
When you need to represent hierarchical relationships (such as subtasks under a step),
you can use indentation — typically two or four spaces — to create nested lists.
Example:
1. Breakfast preparation
- Bread
- Milk
2. Lunch preparation
- Rice
- Vegetables
Rendered Output:
- Breakfast preparation
- Bread
- Milk
- Lunch preparation
- Rice
- Vegetables
Best Practices:
- Use two spaces for indentation.
- Avoid excessive nesting (no more than three levels) to maintain readability.
Markdown list syntax is simple yet powerful.
Unordered lists are ideal for presenting bullet points, while ordered lists are great for showing logical steps.
Maintaining consistent formatting and proper indentation is key to creating clean, professional Markdown documents.
