All tools

Markdown Task List Progress Calculator

Code

Parse a Markdown document's checkbox task list and report completion percentage overall and per section, grouped by the nearest preceding heading

Paste a Markdown document and get back completion stats for every `- [ ]`/`- [x]` checkbox in it: total items, completed items, and a percentage, both overall and broken down per section. A section is defined as the nearest preceding heading of any level, so a README with multiple `##` phases gets a separate progress bar for each one instead of a single flat number. This fills a real gap in the site's Markdown tooling: the existing Table of Contents Generator and Front Matter Parser don't touch task lists at all, and this is a common need for tracking a README-driven project plan or a PR checklist without opening the file in an editor that renders checkboxes.

markdowntask-listchecklistprogressdocumentation

How to use Markdown Task List Progress Calculator

  • 1.Paste a Markdown document containing `- [ ]` or `- [x]` style task list items.
  • 2.Read the overall total, completed count, and percentage at the top.
  • 3.Check the per-section breakdown to see progress under each heading separately, useful for a multi-phase project plan.

Frequently asked questions

How does it decide what counts as a section?
A section is the text of the nearest preceding heading (any level, # through ######) above a given checkbox. Items that appear before the first heading in the document are grouped under "(no heading)".
Which checkbox syntaxes are recognized?
Any of the `-`, `*`, or `+` bullet markers followed by `[ ]` (unchecked) or `[x]`/`[X]` (checked), which covers every common Markdown flavor's task list syntax.
Does it count nested sub-items separately from their parent item?
Every checkbox line is counted individually regardless of indentation; a nested item under a parent task contributes to the same section total as the parent rather than being excluded.
Is my document sent to a server?
No, the browser tool parses everything client-side. The REST API and SDKs process whatever document you send them, same as any other API call.

Use via API, SDK, or MCP

cURL# Free: 1,000 req/day · Pro: 10,000 req/day
curl -X POST https://api.utilix.tech/v1/tools/markdown-task-list-progress \
  -H "Authorization: Bearer utx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Phase 1\n- [x] a\n## Phase 2\n- [ ] b\n- [x] c\n"}'

Get an API key from your dashboard · Full API docs →

Related tools

Markdown Table of Contents GeneratorScan a Markdown document's ATX headings and build a nested table of contents with GitHub-style anchor slugs, disambiguating duplicate headings automaticallyCodeCode Docstring / Comment GeneratorPaste a function or class and get a documentation comment written in the idiomatic style for its language, JSDoc, a Google-style Python docstring, Javadoc, rustdoc, and similar, plus the original code with the comment inserted above it.CodeCompress MarkdownNormalize and compress markdown: strip frontmatter, collapse blank lines, remove comments to reduce token count.AI / Agent