Tasks.md

Self-Hosted

Markdown-powered self-hosted task management tool

Overview

Tasks.md is a lightweight, self-hosted task manager that uses markdown for intuitive task tracking. Create tasks with tags, due dates, and priorities via simple markdown syntax. It supports filtering by status, tag, or due date, and syncs with git for version control. Deploy easily with Docker or as a standalone binary—no database needed, since all data is stored in plain markdown files, simplifying backups and migration. Ideal for users who prefer text-based workflows and value privacy over cloud-based tools.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  tasks_md:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: tasks-md
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Markdown syntax for task creation and editing
No database required (uses plain markdown files)
Docker and standalone deployment options
Filtering by status, tag, due date, and priority

Frequently Asked Questions

? Is Tasks.md hard to install?

No—Tasks.md is easy to install. You can deploy it via Docker with a single command, or run it as a standalone binary. Since it doesn’t need a database, setup is minimal and requires no complex configuration.

? Is it a good alternative to Todoist?

It’s a great alternative if you prioritize self-hosting, privacy, and markdown workflows. It lacks Todoist’s advanced features like natural language processing or team collaboration, but excels at simple, offline-first task tracking.

? Is it completely free?

Yes—Tasks.md is open source under the MIT License. It’s completely free to use, modify, and self-host without any subscription fees or hidden costs.

Top Alternatives

Tool Info

Pricing Free/Open Source

Category Task Management & To-do Lists

Platform Self-Hosted

Pros

⊕ Privacy-focused (data stored locally in markdown files)
⊕ Lightweight and resource-efficient
⊕ Git integration for version control and sync
⊕ Simple, no-frills interface for focused task management

Cons

⊖ Limited collaboration features compared to SaaS tools
⊖ Basic UI with no advanced visualization (e.g., kanban boards)
⊖ Requires manual setup for git sync across devices