Markdown lists are simple - until they aren’t.

Most people know - makes a bullet and 1. makes a numbered list. But once you try nesting, checkboxes, or adding code blocks inside list items, things get weird fast.

Here’s what they don’t tell you:

You Can Reuse 1. Over and Over

1. Wake up
2. Make coffee
3. Write code

Becomes;

1. Wake up
2. Make coffee
3. Write code

This renders correctly and it saves you from manually renumbering when steps change.

Tabs Break Nested Lists

Indent with spaces only. Tabs almost always break things.

• Projects
• Terminal Setup
• Markdown Publishing

Full canonical guide here: https://opengridlab.org/guides/how-to-list-things-in-markdown.html Covers all 7 list types with examples — including task lists, description lists, and nested code.