Lists
How to present structured information using various markdown list types
When you need to present structured information, markdown offers several powerful list types: unordered, ordered, task lists, and definition lists.
Unordered Lists
Unordered lists are perfect for items without inherent order:
- First item in the list
- Second item with more detail
- Third item
- Nested item one
- Nested item two
- Deeply nested item
- Back to top level
You can also use asterisks or plus signs:
- Asterisk item
- Another asterisk item
- Plus sign item
- Another plus item
Ordered Lists
When sequence matters, use ordered lists:
- Preheat the oven to 350°F
- Mix the dry ingredients
- Combine wet ingredients separately
- Fold wet into dry until just combined
- Bake for 25-30 minutes
Markdown automatically numbers these, so you can use 1. for everything:
- First step
- Second step
- Third step
- Fourth step
Mixed Nesting
Lists can contain mixed types and complex nesting:
-
Planning Phase
- Define requirements
- Create timeline
- Allocate resources
-
Development Phase
- Write code
- Implement core features
- Add error handling
- Write tests
- Review and refactor
- Write code
-
Deployment Phase
- Stage for testing
- Run final checks
- Deploy to production
Task Lists
Task lists (checkboxes) are useful for tracking progress:
- Define project scope
- Set up development environment
- Implement core features
- Write documentation
- Deploy to production
Definition Lists
While not standard markdown, many processors support definition lists:
Term One : This is the definition of term one. It can span multiple lines if needed.
Term Two : Definition for term two. : A second definition for term two.
Conclusion
Lists are fundamental tools for organizing information. Choose the right structure for your data, and your readers will thank you for the clarity.