Task Format Converter
Move task lists between todo.txt, Markdown checklists, JSON, and CSV without dropping priorities, projects, contexts, due dates, or metadata tags.
About this tool
The Task Format Converter turns one task list into another common task-list format: todo.txt, Markdown checklists, JSON, or CSV. It parses each task into a shared model before writing the target format, so completion state, priority, +projects, @contexts, creation dates, due dates, completion dates, and extra key:value metadata survive the conversion.
Use it when you are moving tasks between a plain-text todo.txt workflow, a README or issue checklist, a spreadsheet, and a scriptable JSON pipeline. Set the input format explicitly for strict conversions, or choose Auto-detect to sniff JSON arrays/objects, Markdown checklist items, CSV header rows, and otherwise fall back to todo.txt.
Worked example
Input todo.txt:
(A) 2026-08-01 Draft release notes +work @desk due:2026-08-05
Converted to Markdown checklist:
- [ ] (A) Draft release notes +work @desk due:2026-08-05 created:2026-08-01
The task text stays readable, and todo.txt's native creation date is preserved as a created: metadata tag because Markdown checklists do not have a built-in creation-date field.
Limits and edge cases
- Markdown output uses
created:andcompleted:metadata tags for dates that Markdown checkboxes cannot represent natively. - CSV uses a fixed header:
text,done,priority,projects,contexts,created,due,completed,tags. - todo.txt priorities are uppercase single letters such as
(A). - Auto-detect is intentionally simple; choose the source format explicitly if a list could be interpreted more than one way.
FAQ
Which task formats are supported?
The converter supports todo.txt, Markdown checklists, JSON task objects, and CSV with task-oriented columns. JSON may be a single object or an array of objects.
What task fields are preserved?
It preserves task text, done state, uppercase priority, projects, contexts, created date, due date, completed date, and extra key:value metadata tags where the target format can represent them.
Why do dates become tags in Markdown?
Markdown checkboxes only encode checked or unchecked state. To avoid losing todo.txt creation/completion dates, the converter writes them as created: and completed: metadata tags in the checklist item text.
Can it synchronize with a task app?
No. This is an offline format converter for pasted text. It does not connect to Todoist, Things, OmniFocus, Google Tasks, or other external services.
Developer & Automation Access
Run it from the terminal
Same engine as this page, headless — via the gizza CLI:
gizza tool task-format-converter "(A) 2026-08-01 Draft release notes +work @desk due:2026-08-05
x 2026-08-02 2026-08-01 Send invoice +finance"New to the CLI? Get gizza →
Open it by URL
Pre-fill and auto-run this tool with query parameters — the names match the API/CLI:
https://gizza.ai/tools/task-format-converter/?input=%28A%29%202026-08-01%20Draft%20release%20notes%20%2Bwork%20%40desk%20due%3A2026-08-05%0Ax%202026-08-02%202026-08-01%20Send%20invoice%20%2Bfinance&from=auto&to=markdown&pretty=trueMachine-readable descriptor: tool.json — title + parameters JSON Schema for agents.
