Markdown Checklist Generator (Task Lists)

GitHub Flavored Markdown supports task lists: - [x] done and - [ ] todo render as checkboxes. This generator helps you build them — add items, mark them done, nest sub-items, and copy the Markdown source. A live progress bar shows completion percentage.

Progress

0%

Markdown source

How to use the Markdown Checklist Generator (Task Lists)

Add items, type their text, check / uncheck completion. Nested items appear indented in the output. Copy the Markdown source — it renders correctly on GitHub, GitLab, Bitbucket, Obsidian, and most other Markdown renderers that support GFM task lists.

Task lists in GitHub Flavored Markdown

A task list is GitHub Flavored Markdown's checkbox syntax: a list item written - [ ] item renders as an unchecked box and - [x] item as a checked one. On GitHub and similar platforms the boxes are interactive in issues and pull requests, and the repository view tallies how many are done. It is the standard way to track sub-tasks inside a single issue or a README roadmap.

The syntax is fussy — the brackets need a space inside for unchecked, a literal x for checked, and correct indentation for nesting — which is easy to mistype by hand. This generator lets you add items, tick them, and nest sub-items, then emits clean Markdown plus a progress bar showing the completion percentage. The output works anywhere GFM task lists are supported.

Common use cases

  • Issue checklists — build the sub-task list for a GitHub issue or pull request.
  • README roadmaps — show planned and completed features as checkable items.
  • Release checklists — track the steps of a deploy or release process.
  • Nested tasks — lay out sub-items under a parent with correct indentation.
  • Progress at a glance — see the completion percentage before pasting into your doc.

Frequently asked questions

What is the exact task-list syntax?

A list item with brackets: - [ ] (note the space) for unchecked and - [x] for checked. The marker can be -, *, or +, but the space and the lower-case x matter.

Where do task lists render as checkboxes?

GitHub, GitLab, Bitbucket, Obsidian, and most renderers that implement GFM. In plain CommonMark without the GFM extension they appear as ordinary list items with literal brackets.

How do I nest sub-tasks?

Indent the child items under their parent — commonly two spaces. This generator handles the indentation for you so the nesting renders correctly rather than flattening.

Are the checkboxes clickable after I paste them?

On GitHub, task lists inside issues, pull requests, and comments are interactive and update the source when clicked. In rendered README files they display state but are generally not clickable.
Embed this tool on your site

Free to embed, no attribution required (but appreciated). Paste this where you want the tool to appear: