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:

  1. Preheat the oven to 350°F
  2. Mix the dry ingredients
  3. Combine wet ingredients separately
  4. Fold wet into dry until just combined
  5. Bake for 25-30 minutes

Markdown automatically numbers these, so you can use 1. for everything:

  1. First step
  2. Second step
  3. Third step
  4. Fourth step

Mixed Nesting

Lists can contain mixed types and complex nesting:

  1. Planning Phase

    • Define requirements
    • Create timeline
    • Allocate resources
  2. Development Phase

    • Write code
      1. Implement core features
      2. Add error handling
      3. Write tests
    • Review and refactor
  3. 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.