TODO.md

Help & Feedback

Have feedback, an idea, or need help? Contact the maker directly on any channel below.

Direct channels

Reporting a bug or issue

To help resolve problems quickly, please include:

  • Device model and iOS version
  • What you expected to happen vs what actually happened
  • A screenshot or screen recording if one makes it clearer

Privacy note: Never send note contents or files you do not want to share.

Frequently asked questions

How do I get started?

First launch is Choose your vault. Tap Try sample lists to load bundled Markdown lists, or pick a folder of Markdown files — an Obsidian vault, or any other. By default, files tagged todo in YAML frontmatter appear; folder structure stays as it is on disk.

Why is one of my files missing?

By default, a Markdown file appears when its YAML frontmatter tags include todo, even if it has no checkbox tasks. You can choose other visibility tags or turn the tag filter off in Settings to browse all readable Markdown files.

Does TODO.md replace my notes app?

No. Your editor still owns the files. TODO.md is the dopamine list on top of the same checkboxes. Obsidian, another markdown app, or Files — edits in either place stay in the folder.

What does the widget do?

The widget shows tasks from a file you choose. Checking one off writes that completion back to the source markdown file.

How does calendar sync work?

It is off until you enable it. TODO.md mirrors dated tasks into its own Apple Calendar; the markdown task remains the source of truth.

What happens when I turn on reminder capture?

It is opt-in and needs a destination file. TODO.md writes a captured reminder into that file, verifies the write, and only then removes the reminder from your default Apple Reminders list.