TODO.md explained

What is TODO.md?

TODO.md is a Markdown file that holds a project task list, backlog, or implementation checklist in plain text that lives next to the code.

Jun 13, 2026 · 5 min read

TODO.md meaning

`TODO.md` is a simple Markdown file for tracking what still needs to be done in a project. It is not an official standard, but it is a popular, lightweight alternative to an external issue tracker for small projects, personal work, or a focused implementation plan. Because it lives in the repository, it versions with the code and is visible to anyone who clones the project.

Using Markdown task lists

TODO.md usually uses GitHub Flavored Markdown task lists, which render as checkboxes:

# TODO

## In progress
- [ ] Add export to PDF
- [x] Live preview split view

## Backlog
- [ ] Dark theme
- [ ] Keyboard shortcuts

See the Markdown cheat sheet for task list and list syntax.

Why use a TODO.md file

Zero setup compared with an external tracker
Tasks stay next to the code and in version control
Easy to review in a pull request
Readable in any editor, even without a renderer

For larger teams, a full issue tracker scales better, but TODO.md is ideal for quick plans and solo work.

How AI agents use TODO.md

AI coding agents read TODO.md to understand outstanding work and current priorities, and some agents maintain a checklist as they work through a multi-step task. Keeping a clear TODO.md gives an assistant a ready-made plan to follow and update, which keeps long tasks organized.

Edit TODO.md with a preview

Draft and check off tasks in the Markdown Docs online editor, or download Markdown Docs to edit TODO.md on Windows. See more common .md files for AI projects.

Related references

GitHub Flavored Markdown: task lists for checkbox task list syntax.

FAQ

Is TODO.md a standard file?

No. TODO.md is a popular convention, not an official standard. It is a lightweight way to track tasks inside a repository.

How do I make checkboxes in TODO.md?

Use GitHub Flavored Markdown task lists: "- [ ]" for an open task and "- [x]" for a completed one.

When should I use TODO.md instead of an issue tracker?

Use TODO.md for small projects, solo work, or a focused plan. Use a full tracker when many people need assignments, labels, and workflow.

Do AI agents update TODO.md?

Some agents read it for context and maintain a working checklist as they complete multi-step tasks.