md2doMarkdown Task Management

A powerful CLI tool for scanning, filtering, and managing TODO tasks in markdown files. Built with TypeScript, designed for developers who love markdown.

Get Started

View on GitHub

📝

Markdown-Native

Works directly with your existing markdown files. No database, no lock-in.

🔍

Smart Parsing

Extracts TODOs with rich metadata - assignees, priorities, due dates, and tags.

🎯

Powerful Filtering

Filter by assignee, priority, project, tags, due dates, and more.

📊

Rich Statistics

View task breakdowns by priority, assignee, project, or any metadata.

🎨

Beautiful Output

Color-coded priorities, clickable file paths with VS Code integration.

⚡

Fast

Built with performance in mind using fast-glob and TypeScript.

🔄

Todoist Integration

Bidirectional sync foundation with official Todoist API.

🤖

AI-Powered

MCP server integration for Claude and other AI assistants.

Quick Example

bash

# Install globally
npm install -g @md2do/cli

# List all tasks
md2do list

# Filter by assignee and priority
md2do list --assignee nick --priority urgent

# View statistics
md2do stats --by assignee

Task Format

md2do recognizes standard markdown task syntax with rich metadata:

markdown

- [ ] Implement user authentication @nick !!! #backend #auth (2026-01-20)
- [x] Write documentation @jane !! #docs (2026-01-15)
- [ ] Fix bug in parser @alex ! #bug (2026-01-18)

Supported metadata:

@username - Task assignee
!!! / !! / ! - Priority (urgent/high/normal)
#tag - Tags
(YYYY-MM-DD) - Due date
[todoist:ID] - Todoist sync ID

What Makes md2do Special?

🎯 Context-Aware

md2do automatically extracts context from your file structure:

projects/
  acme-app/              # Project: acme-app
    sprint-planning.md
  widget-co/             # Project: widget-co
    roadmap.md
1-1s/
  nick.md                # Person: nick
  jane.md                # Person: jane

🔄 Todoist Sync

Keep your markdown in sync with Todoist:

bash

# Import markdown task to Todoist
md2do todoist import tasks.md:15

# Sync completion status bidirectionally
md2do todoist sync --dry-run
md2do todoist sync

🤖 AI Integration

Use Claude Code or other AI assistants to query your tasks:

"What urgent tasks does @nick have?"

"Show me task breakdown by project"

"Generate my daily standup report"

Next Steps

📚 Get Started - Install and configure md2do

📖 Read the Guide - Learn about task format and features

🔌 Todoist Setup - Set up Todoist integration

🤖 MCP Integration - Connect with Claude Code

💻 CLI Reference - Complete command documentation

Made with ❤️ by Nick Hart

MIT License • Report Bug • Request Feature

md2doMarkdown Task Management

Markdown-Native

Smart Parsing

Powerful Filtering

Rich Statistics

Beautiful Output

Fast

Todoist Integration

AI-Powered

Quick Example ​

Task Format ​

What Makes md2do Special? ​

🎯 Context-Aware ​

🔄 Todoist Sync ​

🤖 AI Integration ​

Next Steps ​