Dada Todo List

Dada Todo List

A task & checklist manager for Obsidian, built entirely on plain Markdown checkboxes. Your tasks live in your own notes — daily notes, an inbox note, and checklist files. No account, no cloud, no lock-in.

简体中文 | English

---

---

📸 界面预览

---

简体中文

Dada Todo List（达达清单） 是一款基于 Obsidian 笔记的待办与清单管理插件。所有任务就是你笔记里的 Markdown 复选框（- [ ] / - [x]），插件负责把它们聚合起来，提供日历、时间轴、日程等多种视图和顺手的编辑体验。

🎯 这个插件适合你吗？

• 🙋 你已经在用 Obsidian 管理待办 —— 任务散落在日记和各处笔记里，找起来靠搜索、看起来只有干巴巴的列表？装上它，你写过的每一行待办都会聚合成日历、时间轴、日程和清单，数据一行都不用搬，还在你原来的笔记里。
• 🌱 你还没试过用 Obsidian 管理待办 —— 不必再注册第 N 个待办服务：你的库就是任务管理器，纯 Markdown 复选框、全本地、跟着笔记永久保存。从一行 - [ ] 开始，慢慢长出属于自己的任务系统。

💡 快速上手

1. 开启核心插件「日记」（设置 → 核心插件）——有日期的任务就存在你的每日笔记里；
2. 点击左侧栏的 ✅ 图标（或命令面板「打开 Dada Todo List」）打开面板；
3. 在任意一篇每日笔记里写下一行 - [ ] 买牛奶 #生活，面板里立刻就能看到。

✨ 功能特性

🗓 六种视图，随意切换

✏️ 顺手的任务编辑

• 标题内联语法：直接写 #标签 和 [文字](链接)，渲染为可点击的标签胶囊与超链接
• 时间灵活：单时间、时间段（开始 – 结束）、全天，三种形态一键切换
• 子任务：无限层级缩进即子任务，弹窗内直接增删改

🖱 效率操作

• 拖拽改期：周 / 月视图之间拖拽任务即可改期；时间轴上还能拖动手柄精细调整开始 / 结束时间
• 过期待办顺延：一键把所有已过期任务顺延到今天（保留原时刻，全天任务保持全天）
• Ctrl/⌘ + 点击：直接跳转到任务所在的笔记并高亮定位
• 待办侧栏：周 / 月视图左侧可展开「无日期 / 所有待办」列表，拖到日历即改期

🔒 数据与隐私

• 纯 Markdown：任务就是笔记里的复选框，插件删除后数据原样保留
• 全本地：不依赖任何外部服务，不联网，天然适配各种同步方案
• 界面记忆：视图、筛选等偏好存本机 localStorage，不污染 data.json、不触发云盘同步

📂 数据访问说明

• 扫描文件列表：插件会枚举库内 Markdown 文件的路径与 frontmatter，用于发现每日笔记与清单文件（清单通过标记全库识别）；只有命中的日记（限加载范围内）、收件箱、清单文件会被读取正文，其余文件一概不碰。
• localStorage：仅存储非必要的界面偏好（当前视图、筛选状态、引导关闭标记等），只存在于本机、不含任何笔记内容、绝不联网同步；刻意不写入 data.json，避免频繁改写触发云盘同步服务。

🌍 界面

• 中英双语：跟随 Obsidian 界面语言自动切换
• 农历支持：月视图 / 周视图表头显示农历、节气与节日，英文界面下同样可用
• 主题跟随：配色全部走 Obsidian 原生变量，深浅色主题、自定义主题色都自动适配

🚀 安装

手动安装：下载 main.js、styles.css、manifest.json 三个文件，放入 你的库/.obsidian/plugins/dada-todo-list/ 目录，然后在设置中启用第三方插件并开启本插件。

BRAT：安装 BRAT 后，添加本仓库地址即可自动更新。

📁 数据存储

三个位置只有收件箱路径与清单标记是本插件的设置项；每日笔记完全跟随你现有的日记配置，装上即用、无需导入。

若核心「日记」插件未开启，面板顶部会出现提醒条，有日期任务暂不可读写，收件箱与清单不受影响。

📝 清单文件的写法

任意一篇笔记，只要 frontmatter tags 含有清单识别标记（默认 todoList）就会成为一份清单。文件里用 ### 三级标题作为分组依据，清单视图按分组展示：

---
tags:
  - todoList
---

### 工作
- [ ] 完成季度汇报 #work
    - [ ] 收集数据
    - [ ] 制作图表
- [x] 回复客户邮件

### 生活
- [ ] 预约牙医
- [x] 给绿萝浇水

规则与技巧：

• ### 标题 = 分组名，可增删改，无需任何额外配置；标题前的任务归入「未分组」
• 缩进的复选框 = 子任务，层级不限
• 清单视图支持列表 / 分栏两种布局；拖拽任务到其他分组即可移动归属
• 每个分组标题旁有 + 按钮可向该分组新增任务；侧栏实时显示各清单的总数与完成进度
• 一篇笔记就是一份清单，任务直接存在这篇笔记里——在编辑器里手动增删改，面板会自动刷新

⚙️ 设置

🌐 语言

界面跟随 Obsidian 的语言设置（简体中文 / English）。切换 Obsidian 语言后重启即可生效。

英文文档见下方 English 章节。

---

English

Dada Todo List turns your Obsidian vault into a full-featured task and checklist manager — powered entirely by plain Markdown checkboxes (- [ ] / - [x]). No accounts, no cloud services, no proprietary database: your tasks are simply lines in your own notes, and the plugin brings them together with calendar, timeline and agenda views plus a polished editing experience.

Who is it for?

• Already managing tasks in Obsidian? If your to-dos are scattered across daily notes and scattered checklists — and finding them means searching — this plugin is for you. It gathers everything you've already written into six views (day / week / month / agenda / checklists / list) with zero migration: your notes stay exactly where they are.
• Haven't tried task management in Obsidian yet? You don't need yet another to-do service. Your vault is your task manager: plain Markdown that stays readable forever, stored locally, synced with whatever you already use. Start with a single - [ ] and grow your own system from there.

Highlights

• Six views — day timeline, seven-day week timeline with lane layout, month calendar (with Chinese lunar dates, solar terms, festivals and statutory holidays), rolling agenda, grouped checklists, and a filterable list of everything
• Inline syntax — write #tags and [links](url) right in the task title; they render as clickable pills and hyperlinks
• Flexible time — single time, time ranges (start – end), or all-day, switchable per task
• Subtasks — indented lines become nested subtasks of any depth
• Drag to reschedule — drag tasks between days, or drag the handles on the timeline to fine-tune start / end times
• Smart extras — overdue postponement in one click, Ctrl/⌘+click to jump to the source note

Installation

Manual: download main.js, styles.css and manifest.json into your-vault/.obsidian/plugins/dada-todo-list/, then enable the plugin in Settings → Community plugins.

BRAT: install BRAT and add this repository.

Where your data lives

Everything is plain Markdown. Uninstalling the plugin changes nothing — your notes stay as they are.

Writing checklists

Any note whose frontmatter tags include the checklist tag (default todoList) becomes a checklist. Use ### third-level headings as group separators — the checklist view renders one group per heading:

---
tags:
  - todoList
---

### Work
- [ ] Finish the quarterly report #work
    - [ ] Collect data
- [x] Reply to client emails

### Life
- [ ] Book a dentist appointment

• ### heading = group name, freely added/renamed/removed; tasks before any heading fall into "Ungrouped"
• Indented checkboxes are subtasks, nesting to any depth
• Switch between list / columns layouts; drag a task onto another group to move it
• Each group has a + button to add tasks; the sidebar shows live total / done progress per checklist

Data access disclosure

• File enumeration: the plugin lists Markdown file paths and their frontmatter to discover daily notes and checklist files (checklists are identified anywhere in the vault by their tags). Only matched daily notes (within the configured load window), the inbox file, and tag-matched checklist files are actually read — no other file's content is ever touched.
• localStorage: stores only non-essential UI preferences (current view, filters, onboarding state) on the local device. It never contains note content and is never synced; it is deliberately not written to data.json to avoid triggering cloud-sync services on every interaction.

Settings

Language

The interface follows Obsidian's language setting (English / 简体中文). Restart Obsidian after switching.

完整的中文文档见上方 简体中文 章节。

---

💖 赞赏支持

如果这个插件对你有帮助，欢迎请作者喝杯咖啡，是我持续更新的动力～

微信赞赏 WeChat Pay

---

🛠 开发

npm install
npm run build     # 生产构建（产物：dada-todo-list/main.js、styles.css、manifest.json）
npm run dev       # 开发模式：监听 src/ 改动自动重建

本地调试：把测试库的插件目录软链到产物目录即可（目录名与插件 id 一致）：

ln -s "$(pwd)/dada-todo-list" "你的库/.obsidian/plugins/dada-todo-list"

📄 License

MIT