Markdown Syntax · Lists

How to Make a List in Markdown
Bullets, numbers, nesting, and checkboxes

A list in Markdown is a marker plus a space at the start of each line: a dash for bullets, a number and a period for an ordered list. Indent to nest, and add brackets for a checklist.

AI answers lean on lists constantly, so you'll read and edit plenty of them. This article covers bulleted, numbered, nested, and task lists — and the small mistakes that stop a list from rendering.

New to the syntax overall? Start with How to Write Markdown.

The four kinds of list

Type Syntax Note
Unordered (bullets) A dash and a space: - item Asterisk (*) or plus (+) also work — stay consistent
Ordered (numbers) A number, period, space: 1. item Numbers auto-renumber; 1. 1. 1. still shows 1, 2, 3
Nested Indent the child under the parent Keep the indent width consistent
Task list (checkboxes) - [ ] to-do and - [x] done A GFM extension; renders as checkboxes

All together:

Unordered — a dash and a space:
- First item
- Second item
  - A nested item (indented)

Ordered — a number, period, and space:
1. First
2. Second

Task list — checkboxes (GFM):
- [ ] Something to do
- [x] Something done

Bullets vs numbers vs nesting

  • Bullets: a dash and a space. Use * or + if you prefer — just don't switch markers mid-list.
  • Numbers: a number, a period, a space. The digits don't have to be sequential; the renderer renumbers, so 1. on every line is fine.
  • Nesting: indent the child items under their parent, and keep the indent width the same throughout — inconsistent indentation is the usual reason a nested list looks off.

Task lists (checkboxes)

Add brackets after the bullet marker: - [ ] for an unchecked item, - [x] for a checked one. This is a GitHub-Flavored Markdown extension and renders as checkboxes wherever GFM is supported — handy for to-do notes.

Why your Markdown list isn't rendering

Symptom What happened Fix
List showed as plain text No space after the marker (-item) Add the space: - item
Nesting looks wrong Inconsistent indentation on child items Use the same indent width throughout the list
List ran into a paragraph No blank line before the list Leave a blank line between the paragraph and the list
Numbers not renumbering Renderer differences The 1. format matters, not the digits — but check your renderer if it won't renumber

The number-one cause: a missing space after the marker. It's - item, never -item — the same goes for 1. item.

Reading and writing lists with NoteLoom

NoteLoom is an editor that reads and writes local .md files right in the browser. Its reading and live views render bulleted, numbered, nested, and task lists — so you see the structure instead of counting dashes — and you write or fix them in the source view, saved straight back to your local file.

To be clear about the boundaries: NoteLoom has no AI — it won't write the list items or turn a paragraph into a list for you. It opens, displays, and saves your Markdown; the content is yours.

How you use it: open app.noteloom.cc in Chrome / Edge / Arc → mount a local folder → open a .md → write your lists in source and watch them in live → save back to your disk, no cloud, no account.

Related reading

How to Write Markdown? Headings, lists, links, code — the basic syntax every beginner needs. How do you write Markdown tables? Table syntax, alignment, and breaks inside cells. Why aren't my Markdown line breaks working? The classic "why doesn't it render" Markdown gotcha. How do you add a link in Markdown? Inline, relative, and reference-style links. Online Markdown Editor Read and write local md files in your browser — lists and all.

FAQ

How do I make a bulleted list in Markdown?
Start each line with a dash and a space: - item. Asterisks (*) and plus signs (+) work too — pick one and stay consistent. The space after the marker is required; -item without a space won't render as a list.
How do I make a numbered list?
Start each line with a number, a period, and a space: 1. item. The actual numbers don't have to be right — most renderers renumber automatically, so you can write 1. 1. 1. and still get 1, 2, 3. Just keep the period-and-space format.
How do I nest a list?
Indent the child items under their parent — commonly two spaces (some renderers want the child aligned under the parent's text). Keep the indentation consistent within a list; mixing widths is the usual reason nesting looks wrong.
How do I make a checklist / task list?
Use the GFM task-list syntax: - [ ] for an unchecked item and - [x] for a checked one. It renders as checkboxes in tools that support GitHub-Flavored Markdown. NoteLoom supports GFM, so task lists render there.
Why isn't my Markdown list rendering?
Most often: no space after the marker (write - item, not -item); inconsistent indentation on nested items; or a missing blank line before the list starts (some renderers need one between a paragraph and a list). Check those three.
Can NoteLoom help with lists?
NoteLoom opens your local .md and renders bulleted, numbered, nested, and task lists in the reading and live views, so you can see the structure instead of counting dashes — and you write or fix them in the source view. It has no AI: it won't generate the list content, just display and save your Markdown locally.
Can I do this with NoteLoom on my phone or in Safari?
Not for now. NoteLoom relies on the browser's File System Access API, which currently works in Chromium-based desktop browsers like Chrome, Edge, and Arc; Firefox, Safari, and mobile aren't supported yet.

See your lists, don't count dashes

Open NoteLoom in Chrome / Edge / Arc, mount a local folder, and write your lists in the source view — the reading and live views show the structure, checkboxes and all. Saved straight back to your disk, no software to install and no account to sign up for.

Open NoteLoom and try it