夜雨聆风
Obsidian 月历任务插件一款在 Obsidian 中以月历视图管理和查看任务的社区
一、这个插件解决什么问题
我日常用 Obsidian 记笔记，也会在里面写一些待办事项，格式大概是这样：
– [ ] 周五前交报告
– [ ] 下周约牙医
– [ ] 买菜：鸡蛋、牛奶、青菜
写的时候挺方便，但过几天想看看「最近有什么事没做」，就得把笔记一个个翻一遍，任务散落在不同的文件里，很难有一个整体的印象。
我也试过 Obsidian 自带的 Tasks 插件，它能把所有任务搜出来列成一个列表，但列表一长，还是缺少时间上的直观感——哪天忙、哪天闲、哪天有deadline，看不出来。
所以做了这个插件。它的核心思路很简单：把你笔记里的任务，按日期放到一个月历格子里。打开月历，一眼就能看到整月的任务分布情况。点一下日期格子就能新建任务，点一下已有的任务就能标记完成或取消完成。整个过程不需要离开月历界面。
二、主要功能
月历视图：7 行 6 列的网格布局，类似滴答清单或系统日历的月视图风格
任务扫描：自动扫描仓库中所有 Markdown 文件里的任务项（兼容 Tasks 插件的 – [ ] 格式）
快捷操作：点击日期格子弹出创建窗口；点击任务即可切换完成状态
农历显示：每个日期格子下方显示对应的农历日期（如初一、十五）和节气（如立春、清明）
节假日标注：自动标注法定节假日（显示为红色/高亮），以及调休上班日
跨天任务：可以创建持续多天的任务（比如出差、假期），在月历上以横条形式跨越多个日期格
优先级标记：支持高 / 中 / 普通三级优先级，分别用不同颜色区分
时间设定：采用原生时间选择器，点击即可快速选择具体时间，操作更直观便捷
已完成任务样式可选：带删除线保留、正常显示、或者直接隐藏不显示
移动端适配：手机上使用 Obsidian 时也能正常操作，按钮和间距针对触屏做了调整
深色模式：跟随 Obsidian 的主题自动切换亮色和暗色样式
三、安装方法
方式一：手动安装（推荐大多数用户）
第一步，下载插件文件。
打开 GitHub 仓库的 Release 页面
下载最新的压缩包（文件名类似 obsidian-monthly-tasks.zip）
第二步，解压到插件的目录。
找到你的 Obsidian 仓库文件夹
进入 .obsidian/plugins/ 目录（如果没有 plugins 文件夹就手动创建一个）
在里面新建一个叫 monthly-tasks 的文件夹
把压缩包里的文件全部解压进去，最终结构应该是这样：
你的仓库/.obsidian/plugins/monthly-tasks/
├──main.js
├──styles.css
├──manifest.json
└──src/
第三步，在 Obsidian 里启用插件。
打开 Obsidian，点左下角齿轮图标进入「设置」
选左侧的「社区插件」
确保「安全模式」是关闭的（如果开着就关掉）
在插件列表里找到「月历任务」，打开开关启用
启用成功后，左侧边栏会出现一个日历图标，点击就能打开月历视图。第一次打开时可能会花几秒钟扫描任务，之后就会很快了。
方式二：通过 BRAT 插件安装（适合开发者或喜欢尝鲜的用户）
先安装 BRAT 插件：Obsidian 社区插件市场里搜索 BRAT，安装并启用
按 Ctrl/Cmd + P 打开命令面板，运行 BRAT: Add a beta plugin for testing
粘贴仓库地址：https://github.com/duany2026/obsidian-monthly-tasks
确认后 BRAT 会自动拉取并安装，然后启用即可
用这种方式安装的是最新代码（包括可能还没正式发布的改动），适合愿意帮忙测试的用户。普通用户建议用第一种方式，更稳定。
四、基本用法
4.1 打开月历视图
方式 A：点击左侧边栏的日历图标
方式 B：按 Ctrl/Cmd + P 打开命令面板，搜索「月历任务」，选择「打开月历任务视图」
月历打开后默认显示当前月份。顶部有左右箭头可以切换月份，也可以点击月份名称快速跳转。
4.2 在月历中创建任务
最直接的方式：在月历上点击任意一个日期格，会弹出一个创建任务的窗口。在这个窗口里你可以：
填写任务的内容（必填）
选择优先级：高（红色）/ 中（黄色）/ 普通（灰色），默认是普通
设定时间：默认是全天任务，关闭「全天」开关后可以使用原生时间选择器快速选取具体时间
设置跨天：开启「跨天任务」后可以指定结束日期，任务会以横条形式覆盖多天
填好之后点「添加任务」就行。任务会被保存到 Obsidian 仓库的任务目录下，文件名按年月命名，格式是 Markdown，兼容 Tasks 插件。也就是说你之前用 Tasks 插件写的任务，这个插件也能识别和显示，反过来也一样。
4.3 在笔记中直接写任务
除了在月历上点来点去，你也可以像平时一样在笔记里手写任务。只要格式符合规范，保存后月历会自动刷新显示。基本格式是这样的：
– [ ] 任务内容 📅 2026-04-22
– [x] 已完成的任务 🔴 📅 2026-04-20
– [ ] 有具体时间的任务 🟡 ⏰ 14:00 📅 2026-04-23
这里用到一些特殊的 emoji 标记，含义如下：
|
标记 |
说明 |
|
📅 YYYY-MM-DD |
截止日期，表示任务应该在哪天完成 |
|
⏰ HH:mm |
具体的截止时间，需要配合📅一起使用 |
|
🛫 YYYY-MM-DD |
开始日期（用于跨天任务，配合📅结束日期使用） |
|
🔴 或 ⏫ |
高优先级，在月历中以红色标识 |
|
🟡 或 🔼 |
中优先级，在月历中以黄色/橙色标识 |
4.4 跨天任务
有些事情不是一天能做完的，比如出差、休假、项目周期等。跨天任务可以在创建窗口中开启「跨天任务」开关，然后指定一个结束日期。
在手写格式中，需要同时标注开始日期和截止日期：
– [ ] 公司年会 🛫 2026-05-01 📅 2026-05-03
这种任务在月历上会以横条的形式展示，从开始日期一直延伸到结束日期，覆盖中间的所有日期格子，看起来比较直观。
4.5 标记任务完成 / 取消完成
在月历上点击任何一个未完成任务，会立即标记为已完成（方框打勾）
再点击一次已完成的任务，会恢复为未完成状态
已完成的任务在月历上的显示效果取决于你的设置（见下一节）：可以是加删除线、正常文字、或者完全隐藏
五、设置选项
打开 Obsidian 设置 → 社区插件 → 月历任务，可以看到以下选项：
|
设置项 |
说明 |
|
已完成任务显示方式 |
三个选项：带删除线（保留但划掉）、正常显示（和未完成一样）、隐藏不显示。用分段按钮切换。 |
|
显示农历 |
开关选项。开启后在每个日期格子的下方显示农历日期和节气信息。 |
|
显示节假日 |
开关选项。开启后在月历上标注法定节假日（高亮）和调休上班日。节假日数据从网络 API 获取。 |
|
刷新节假日数据 |
按钮。手动触发一次节假日数据更新（一般不需要手动操作，插件启动时会自动获取当年数据）。 |
|
默认全天任务 |
开关选项。开启后，通过月历创建新任务时默认不带具体时间（即全天任务）。关闭则默认需要选时间。 |
|
每周第一天 |
下拉选择：周一 或 周日。决定月历每一行的起始日是周一还是周日，默认周日。 |
|
每日任务显示数量 |
下拉选择：3 到 10 个。当某天的任务超过这个数量时，超出的部分会折叠成「更多 N 项」的文字提示。默认 5 个。 |
六、数据存储
关于你的任务数据存在哪里，这里说明一下：
任务以 Markdown 格式存储在你的 Obsidian 仓库中
具体路径是：任务/ 目录下，按年度命名文件（例如 任务/2026年任务列表.md），按月份分组存储
每个任务就是文件中的一行 Markdown，格式标准，可以直接用编辑器打开修改
数据和 Obsidian Tasks 插件完全兼容，两个插件可以同时使用而不冲突
节假日数据缓存在插件的配置文件中（.obsidian/plugins/monthly-tasks/data.json），不需要联网也能用（首次获取后本地缓存）
简单来说，你的数据始终在你自己的电脑上，不会上传到任何服务器。卸载插件后任务文件还在，不会丢失。
七、常见问题
Q: 安装后左侧边栏没有出现日历图标？
检查几个地方：确认插件已经启用（设置 → 社区插件 → 月历任务的开关是打开的）；确认 Obsidian 版本在 0.15 以上；尝试重启 Obsidian。
Q: 月历上看不到我写的任务？
确认你的任务格式是否正确：必须是以 – [ ] 或 – [x] 开头的列表项，并且包含了日期标记（如 📅 2026-04-22）。纯文字的待办事项（没有日期标记的）不会被扫描到。另外注意日期格式必须是 YYYY-MM-DD，不能省略前面的年份。
Q: 农历/节假日信息不对？
节假日数据来自第三方 API（timor.tech）。如果发现数据有误，可以在设置页面点击「刷新节假日数据」按钮重新拉取一次。农历计算覆盖 1900 年到 2100 年，一般不会有问题。
Q: 手机上能用吗？
能用。做过移动端适配，基本的浏览和创建任务操作都没问题。不过屏幕小的时候，日期格子会比较紧凑，任务多的日子可能需要点进去看详情。
Q: 和 Tasks 插件冲突吗？
不冲突。两者读取的是同一种 Markdown 任务格式，数据完全兼容。你可以同时安装两个插件，Tasks 负责列表管理，月历负责时间维度的可视化。
Q: 能同步到手机吗？
能。因为任务文件就是普通的 Markdown 文件，放在你的 Obsidian 仓库里。只要你用了 Obsidian 的同步方案（官方同步、iCloud、OneDrive、Git 等），文件同步过去后手机端就能看到。
八、关于这个插件
这个插件是我个人在做 Obsidian 笔记管理时顺手做的，最初只是为了自己用着方便。后来觉得可能也有别人有同样的需求，就整理了一下开源出来了。
目前的功能都是我在实际使用过程中逐步加上去的，没有什么特别炫酷的技术，主打一个实用、轻量、不打扰。代码量不大，也不依赖任何第三方库，安装包只有不到 80KB。
如果你在使用过程中遇到问题或有功能建议，欢迎到 GitHub 上提 Issue。
|
GitHub 仓库 |
https://github.com/duany2026/obsidian-monthly-tasks |
|
开源协议 |
MIT License（可自由使用、修改、分发） |
|
当前版本 |
v1.2.4（2026 年 4 月 22 日） |