Tasks.md
基于 Markdown 文件的自托管看板工具，一条 Docker 命令部署，任务即文件，数据完全在你手里。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
用 Markdown 文件当数据库的任务看板，自托管、轻量、隐私优先
核心功能
- 任务就是 .md 文件，可用任何编辑器修改，支持 Git 版本控制
- 一条 Docker 命令完成部署，开箱即用
- 现代化界面，支持拖拽、标签、深浅色主题（同步系统设置）
- 可安装为 PWA 桌面应用，语言自动检测并持久化
- 3 套内置主题（Adwaita、Nord、Catppuccin），支持 CSS 变量自定义
避坑指南
- •升级从 2.x 到 3.x 需要手动迁移（官方有迁移指南），直接拉镜像可能出问题；2. 若设置 BASE_PATH 为非根路径，PWA 功能会失效；3. 不支持多用户登录，只能给单人或同一信任网络使用；4. 没有原生 API 接口，无法与其他工具深度集成；5. 任务文件必须保持 UTF-8 编码，否则显示乱码。
适用场景
- 个人任务管理：用 Markdown 写任务，本地存储，不依赖任何云服务
- 小团队看板：自建服务器，数据安全可控，协作可通过共享文件夹或 Git 同步
- Obsidian 用户增强：配合 Obsidian 直接编辑任务文件，实现双链笔记与任务管理一体化
Tasks.md 是一个自托管的看板任务管理工具，其核心特点是所有任务都以纯 Markdown 文件存储。它提供现代化响应式界面，支持拖拽列表、标签分类和深浅色主题。部署只需一条 Docker 命令，支持 PWA 安装到桌面，浏览器语言自动识别。因为任务就是 .md 文件，你可以用任何文本编辑器编辑、用 Git 做版本控制，数据完全由你掌控。界面布局基于文件夹结构：每个列表对应一个目录，每个任务对应一个文件。提供 3 套预设主题（Adwaita、Nord、Catppuccin），也支持通过 CSS 变量深度定制。适合追求隐私、偏爱本地文件管理的个人或小团队。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在服务器上运行 Docker 命令（详见 README），挂载 /tasks 和 /config 目录
步骤2：打开浏览器访问 http://服务器IP:8080，即可看到空白看板
步骤3：在界面上新建列表和任务，系统会自动在 /tasks 目录下创建对应文件夹和 .md 文件
- 步骤1：在服务器上运行 Docker 命令（详见 README），挂载 /tasks 和 /config 目录
- 步骤2：打开浏览器访问 http://服务器IP:8080，即可看到空白看板
- 步骤3：在界面上新建列表和任务，系统会自动在 /tasks 目录下创建对应文件夹和 .md 文件
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器：docker stop tasks.md && docker rm tasks.md。然后删除挂载的 /tasks 和 /config 目录即可。注意：任务文件如果未备份会永久删除。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
5 FAQs