/todo.md

TODO.md file format - todomd.org

TODO.md

What is TODO.md?

Why keep a TODO.md?

For a project, there any many sources of information like Documentation, Issue forum, Wiki pages, etc. It is hard to find out about the current progress.

Keeping a TODO.md file makes it easier for anyone who wants to know about the project's plans and work that needs to be done.

Why not using online management tools?

Often times, a new project starts with a list of tasks to outline what needs to be done quickly.

Although some online tools are useful to manage larger projects efficiently, using them in the early stages will add more effort and overhead for small projects.

A few other reasons like: portable plain text format, same project directory, offline working, privacy, versioning (using git), minimalist tool, etc.

TODO.md format

  • TODO.md can have multiple columns.
  • Each column has tasks that start with a checkbox sign - [ ] or just a hyphen -
  • Completed column name must contain or [x].
  • There are "2 spaces" at the end of every task title to serve as line breaks on Github pages.
  • Tags, mentions, estimates, date time, ticket id, etc. can be entered at the end of the task title.
  • A task with 2 space indentation in the title is a sub-task or description.
# Project Name
Project Description

### Column Name
- [ ] Task title ~3d #type @name yyyy-mm-dd  
  - [ ] Sub-task or description  

### Completed Column ✓
- [x] Completed task title  
### Column Name
- Task title ~3d #type @name yyyy-mm-dd  
  - Sub-task or description  

### Completed Column ✓
- Completed task title  

See also