Move from TODO.md and Markdown to Taskhold
Originally published at taskhold.com. Short answer: Open Import in Taskhold, pick TODO.md and Markdown and drop the file or paste its text. The preview shows every task, step and note and where each field lands before
Originally published at taskhold.com.
Short answer: Open Import in Taskhold, pick TODO.md and Markdown and drop the file or paste its text. The preview shows every task, step and note and where each field lands before anything is saved. One click undoes the import, and running it again later skips what came over the first time.
Taskhold is a task list you share with your coding agents: you add and order tasks, agents plan them into steps and report progress you watch on the live board. Importing from TODO.md and Markdown is a one-time move, not a sync, so your history comes with you and the file itself isn't changed.
The steps below are the same ones the Import page shows. Import your tasks lists every source the importer reads, and Taskhold vs TODO.md and Markdown says when to stay put.
Import the file
- Drop the file, or paste its text.
- Check the preview and click Import.
What comes over from TODO.md and Markdown
| In TODO.md and Markdown | In Taskhold |
|---|---|
| Checkboxes as tasks, nested ones as steps | Carried over |
| Checked, canceled [-] and in-progress [/] states | Carried over |
| Headings as labels | Carried over |
| #tags | Carried over |
| Obsidian Tasks dates and priorities, Dataview fields | Carried over |
| Logseq TODO, DOING, DONE, WAITING and [#A] priorities | Carried over |
Fields Taskhold has no column for are kept word for word under Imported details at the end of the task's description. The preview lists each one with a count.
What doesn't come over
- Prose outside checklists
After the import
Imported tasks keep their original created and completed dates, and each one's history starts with "Imported from TODO.md and Markdown". Your agent sees them at once: ask it to "work on the next task" and it picks the highest-priority one, plans it into steps and reports on the live board. The quickstart connects an agent in a minute.
Agents can import too. POST /api/import with the file's text and a project name brings a TODO.md, todo.txt or CSV in with one call; the REST API docs have the details.
FAQ
Does Taskhold keep reading the file?
No. An import is a one-time copy. The file isn't changed, and edits made to it afterwards don't show up in Taskhold until you import it again (a re-run adds only what's new).
What if I import the same thing twice?
Each imported task remembers where it came from, so a second import skips what is already there and adds only what's new. Choose Update instead of Skip to refresh titles, status, steps and notes from the source.
Can I undo an import?
Yes. The last screen of the import, and the Recent imports list on the Import page, have Undo this import. Undo removes the tasks, steps, notes, labels and projects the import made and restores any task it updated.
Related
- Import tasks into Taskhold from any app or file
- Move from Taskwarrior to Taskhold
- Move from todo.txt to Taskhold
- Taskhold vs a TODO.md file for coding agents
About Taskhold
Taskhold is a hosted task list shared by a person and their AI coding agents over MCP. Agents break tasks into steps and report progress, and the person watches a live board. $12/month or $120/year per person, 7-day trial with a card, no free plan. Made by Great Work LLC.
To try it, add the MCP server https://taskhold.com/api/mcp to your agent. It connects with no sign-up, and the first time the agent uses Taskhold it gives you a link to start the trial.
- Pricing: https://taskhold.com/#pricing
Originally published by Dev.to AI. Aggregated on AIWithGhost for educational purposes β full credit and traffic to the original publisher.