Note Calendar：Obsidian的智能日历插件，融合农历、节日与笔记管理

Obsidian 是知识管理爱好者的首选工具，但原生日历功能较为基础。如果你希望在笔记库中拥有一个可定制化、支持农历/节日显示、并能与笔记深度联动的日历工具，Note Calendar 正是为你打造的解决方案。

---

1 插件简介

Note Calendar 是一款面向 Obsidian 的全功能日历插件，它不止是简单的日期查看器，更是笔记创建与回顾的核心入口。通过右侧栏快速打开日历，你可以一站式查看公历、农历、节气、节日和调休信息，每个日期下方的彩色圆点会直观提示当日是否有笔记；点击日期即可在下方列表查看对应笔记，还能一键创建日记、周记、季度笔记或年度笔记，让日历成为连接笔记与时间的桥梁。

2 核心功能亮点

2.1 高度可定制的基础日历

• 基础导航：默认显示当前月份，支持上下月/年快捷切换，配备「今天」按钮一键返回当前日期，无需手动翻页。
• 个性化布局：可自定义一周起始日（周一/周日），适配不同使用习惯；周六、周日颜色支持自定义，且能根据调休状态智能变色（如周末上班显示工作日颜色、工作日放假显示周末颜色）。
• 视觉适配：字体、字号均可自由调整，满足不同显示偏好；日历采用响应式布局，自动占满右侧栏，高度自适应，适配不同屏幕尺寸。
• 周数可视化：日期表格左侧增设周数列，清晰显示每行对应的全年周数（1-52/53），周数列与日期表格样式统一，竖线分隔更清晰。

2.2 农历、节日与调休一目了然

• 多层级日期展示：日期单元格内从上到下依次显示：公历日期 → 农历日期 → 农历节日 → 阳历节日 → 节气，信息层级清晰不杂乱。
• 农历特色显示：农历每月初一自动替换为月份名称（如"腊月"），年月标题旁同步显示农历年月（如"己巳蛇年 二月"），兼顾传统日期习惯。
• 调休智能标记：单元格右上角以"休"/"班"空心方框标记调休信息，"休"字匹配周末颜色、"班"字匹配工作日颜色（白色），选中状态下颜色自动反转。
• 灵活的显示控制：公历节日、农历日期、农历节日、节气、调休标记均可单独开关，按需显示信息，避免界面冗余。

2.3 精致的视觉与交互细节

• 主题色自定义：默认紫色（#5d4ed8）主题色可全局修改，影响范围覆盖今日日期、选中边框、节日文字等核心元素，适配个性化审美。
• 优化的选中样式：选中日期无背景色，仅显示 2px 主题色边框，避免内容撑开导致的布局跳动；单元格固定尺寸（min-height: 60px），网格渲染后宽高稳定，交互更流畅。
• 统一的样式规范：采用 CSS 变量（--calendar-primary）实现样式统一，box-sizing: border-box 确保布局精准，所有元素视觉风格一致。

2.4 笔记关联：让日历成为笔记入口

• 笔记存在标记：若某日有笔记（创建/更新日期匹配），单元格底部会显示小圆点图标------创建日期为绿色、更新日期为蓝色，同一日期下的笔记仅显示一次，创建与更新日期重合时优先显示创建标记。
• 笔记列表预览：选中日期后，日历下方专属容器会展示该日所有笔记（格式：YYYY年MM月DD日），列表项前标注与日历单元格一致的彩色圆点，点击标题可直接打开笔记，容器风格与日历界面统一，简洁不突兀。
• 自动扫描与更新：支持设置笔记文件夹路径，初始化时自动扫描笔记，后续文件创建、修改、重命名均实时更新索引；配备"重新扫描"按钮，可手动触发全盘扫描，确保笔记标记精准。

2.5 一键创建各类周期性笔记

在笔记列表容器的日期标题左侧，提供一组便捷创建按钮，满足不同周期的笔记需求：

• +（日记）：默认标题为当前日期（可自定义格式，默认 YYYY-MM-DD）；
• 周（周记）：默认标题为"YYYY-n周"（n 为当前周数）；
• 季（季度笔记）：默认标题为"YYYY年-n季度"（n 为1-4季度）；
• 年（年度笔记） ：默认标题为"YYYY"（当前年份）。
  点击按钮弹出创建对话框，可修改标题、指定存储文件夹（自动创建不存在的路径），确认后即刻生成空笔记，且自动刷新日历笔记标记；标题为空或点击取消时不创建笔记，避免误操作，创建成功后还会给出通知提示。

3 安装方式

Note Calendar 暂未上架官方社区插件市场（审核中），当前可通过以下两种方式安装：

3.1 方法一：使用 BRAT 插件

1. 在 Obsidian 社区插件市场安装 BRAT 插件；
2. 打开 BRAT 设置，点击「Add Beta plugin」，输入插件仓库地址：
   https://github.com/Is-Ming/obsidian-note-calendar；
3. 在 Obsidian 插件设置中启用 Note Calendar。

3.2 方法二：手动安装

1. 前往 GitHub 发布页面下载最新版本的插件压缩包note-calendar.zip；
2. 将插件压缩包note-calendar.zip解压,解压后的文件夹名称为note-calendar，文件夹内包含（main.js,mainfest.json,styles.css,lunar.js 四个文件）
3. 在 Obsidian 库的 .obsidian/plugins/ 目录下，将解压后的note-calendar放入目录中。
4. 重启 Obsidian，在设置中启用 Note Calendar 插件。

4 使用入门

1. 打开日历：启用插件后，Obsidian 右侧栏顶部会出现日历图标，点击即可打开日历视图；
2. 初始配置：首次使用建议进入插件设置页，配置笔记文件夹路径、一周起始日、周末颜色、字体等外观选项，以及是否显示农历/节日/调休等内容；
3. 建立索引：设置完成后点击"重新扫描"按钮，插件会扫描指定文件夹的笔记并建立索引，日历随即显示各日期的笔记标记；
4. 使用核心功能 ：
   • 点击日期查看对应笔记列表，点击笔记标题可直接打开；
   • 点击"+"/"周"/"季"/"年"按钮，按提示创建对应类型的笔记。

5 插件展示

• 日历主界面：展示月份视图、周数列、农历/节日/调休标记、笔记圆点；
• 设置面板：呈现起始日、颜色、显示开关、字体等可配置项；
• 笔记列表：选中日期后，下方列表显示带彩色圆点的笔记标题；
• 创建笔记对话框：点击"+"后弹出的标题/路径输入界面；
• 整体效果；

6 结语

Note Calendar 打破了日历与笔记的边界，将简单的日期查看工具升级为笔记的时光索引 。无论是日常记录、项目规划，还是知识回顾，它都能帮你快速定位特定日期的笔记，并轻松创建周期性笔记，让时间管理与知识管理无缝融合。

如果你对农历、节日显示有需求，或希望让日历与笔记更紧密地结合，这款插件值得一试。欢迎访问 GitHub 仓库 了解更多细节，也欢迎反馈问题或提出功能建议。

Happy noting!