tasks.md

Manage Tasks Your Way: In Markdown

A simple, powerful, and local-first task management tool built for text lovers and command-line aficionados.

Try the Web App

Markdown Native

Work directly with plain text Markdown files. Your tasks are portable, version-controllable, and always under your control.

Local First & Private

Your data stays on your device. No mandatory cloud accounts. Sync optionally via Git, OneDrive, Dropbox, etc.

Cross-Platform Access

Use the clean web interface now. A native desktop app is coming soon for a focused, offline-capable experience.

How It Works: The Basics

Markdown Task Format

Tasks are simple lines in your Markdown files:

- [ ] (A) task to do +plustag @attag #hashtag due:2025-12-31 rec:1w
  • Starts with - [ ] (incomplete) or - [x] (complete).
  • Optional priority: (A), (B), etc.
  • Supports tags: +project, @context, #category.
  • Special tags for metadata: due:YYYY-MM-DD, rec:1w (recurrence).

Basic Commands (via Command Palette: Cmd+K)

Interact quickly using simple commands:

  • Add: a [task description]
  • Complete: d [index]
  • Uncomplete: undone [index]
  • Edit: e [index] [new description]
  • Remove: rm [index]
  • Filter: f [tag]