How do I make a checkbox in Markdown?

Write a bullet item and put [ ] for an empty box or [x] for a checked box right after the bullet, with a space after the closing bracket: - [ ] Task.

Do Markdown checkboxes work everywhere?

They are part of GitHub Flavored Markdown, so they render as checkboxes on GitHub, GitLab, and many editors. Plain CommonMark viewers may show them as text.

Can I nest subtasks under a task?

Yes. Indent the child items by two spaces so they sit under the parent task. Preview the list to confirm the nesting renders correctly.

Markdown editor guide

Markdown Task List and Checkboxes

Create checkbox task lists in Markdown for READMEs, GitHub issues, and personal to-do notes with live preview.

Direct answer

A Markdown task list is a bullet list where each item starts with [ ] for an empty checkbox or [x] for a checked one, like - [ ] Todo and - [x] Done. GitHub Flavored Markdown renders these as clickable checkboxes. Draft the list in a live editor to confirm the spacing is correct before you paste it.

Open the Markdown Editor

When to use this

You want a checklist inside a README, issue, or pull request.
You are tracking a personal to-do list in a Markdown note.
You need nested subtasks under a parent task.

Steps

Start each line with a bullet marker: - , * , or +.
Add a checkbox with [ ] for unchecked or [x] for checked, and one space after it.
Indent a line with two spaces to nest a subtask under its parent.
Keep a blank line before the list so it does not merge with a paragraph.
Preview to confirm the checkboxes render and nesting looks right.

Example

Markdown you type

## Launch checklist

- [x] Draft the content
- [x] Add FAQ schema
- [ ] Run the build
  - [ ] Fix any type errors
  - [ ] Confirm static export
- [ ] Publish

How it renders

Launch checklist  (H2)

[x] Draft the content        (ticked)
[x] Add FAQ schema           (ticked)
[ ] Run the build            (empty)
    [ ] Fix any type errors  (nested, empty)
    [ ] Confirm static export
[ ] Publish

Common mistakes

The brackets need a space inside for an empty box: - [ ] , not - [].
A checked box is a lowercase x: - [x] ; an uppercase X may not render on every platform.
Nest subtasks with two spaces of indentation, not a tab, for the most consistent rendering.

FAQ

How do I make a checkbox in Markdown?: Write a bullet item and put [ ] for an empty box or [x] for a checked box right after the bullet, with a space after the closing bracket: - [ ] Task.
Do Markdown checkboxes work everywhere?: They are part of GitHub Flavored Markdown, so they render as checkboxes on GitHub, GitLab, and many editors. Plain CommonMark viewers may show them as text.
Can I nest subtasks under a task?: Yes. Indent the child items by two spaces so they sit under the parent task. Preview the list to confirm the nesting renders correctly.

Related Markdown editor guides

Markdown Syntax Cheat Sheet

A copy-ready Markdown cheat sheet covering headings, bold, italics, lists, links, images, code, tables, and blockquotes.

How to Write a README in Markdown

Structure a clear README.md with a title, badges, install and usage sections, and a live preview before you commit.

Markdown Table Syntax

Write Markdown tables with pipes and dashes, set column alignment, and keep them readable in the editor before you paste.

Markdown for GitHub Comments

Format GitHub issue and pull request comments with task lists, code blocks, mentions, and collapsible sections.

Markdown Editor With Live Preview Online

Edit Markdown on the left and see the rendered result on the right in real time, with no login and browser-only drafts.

How to Add Links and Images in Markdown

Add inline links, reference links, and images in Markdown, including titles and clickable image links.

Markdown Code Blocks and Syntax Highlighting

Add fenced code blocks with a language for syntax highlighting, plus inline code, in Markdown.

Desk gear for long writing sessions

A few things that help if you write docs, tickets, and specs on a laptop all day.

Dock

Anker 5-in-1 USB-C Hub

One cable turns a laptop into a desk setup. Drives a 4K display, charges at up to 85W, and adds three data ports.

4K HDMI output
85W max power delivery
1x USB-C + 2x USB-A, 5Gbps each
MacBook Pro, MacBook Air, Dell

Check price on Amazon →Monitor · I use this

Dell 27" S2725QC 4K

The monitor I write and review documents on. 163 PPI keeps small text sharp, and USB-C carries video and power on one cable.

3840x2160 IPS, 163 PPI
120Hz, 4ms, FreeSync Premium
99% sRGB
USB-C, HDMI, DisplayPort

Check price on Amazon →Laptop

Apple MacBook Neo 13" (A18 Pro)

The cheapest way into an Apple-silicon machine that runs local models. Fanless, and the Liquid Retina panel holds small text at a full day of reading.

A18 Pro chip, built for Apple Intelligence
8GB unified memory, 256GB SSD
13-inch Liquid Retina display
1080p FaceTime HD camera

Check price on Amazon →

Amazon affiliate links. We earn a commission on qualifying purchases at no extra cost to you.