Continuous Journal Calendar

An Obsidian calendar that opens, creates, and tracks dated sections inside one Markdown note.

Continuous Journal Calendar is designed for people who keep a continuous journal instead of creating a separate daily note for every date. The calendar lives in the sidebar, while every entry stays in the master note you choose.

Community directory submission is in progress. Until it is approved, install the plugin manually from the latest GitHub release.

Highlights

• One note, not hundreds of files. Every date points to a section in the same Markdown document.
• Correct chronological placement. Missing dates are inserted newest-first, even when you add an older entry later.
• Instant navigation. Click an existing date to open the master note and jump to its section.
• Calendar status at a glance. See which dates have content and which contain unfinished Markdown tasks.
• Existing-note friendly. Recognizes both heading-style and legacy bare date markers.
• Timeline repair. A built-in command can reorder dated sections without changing their contents.
• Desktop and mobile. The plugin uses only Obsidian APIs and has no runtime services or external dependencies.

How it works

The plugin looks for date markers in a master note:

### 📅 2026-09-02

Clicking a date then follows one of two paths:

1. If the date already exists, the plugin opens the master note and scrolls to it.
2. If the date is missing, the plugin creates a new dated section in the correct position and opens it.

It never creates one file per day.

Note format

Your note can contain tables, plans, or any other content above the journal area. Only the journal heading and date-marker lines are significant to the plugin.

# Daily record

| Date | Important item | Next action |
| --- | --- | --- |
| 2026-09-02 | Prepare release | Submit for review |

## 📖 Journal

### 📅 2026-09-02

#### Important progress

- Released version 1.0.0.

Today I finished the first public version.

### 📅 2026-09-01

#### Important progress

- Completed the calendar layout.

Supported date-marker styles include:

### 📅 2026-09-02
📅 2026-9-2
📅 2026年9月2日

The marker must be on its own line. Newly created sections use the ISO format YYYY-MM-DD.

Installation

From the Obsidian community directory

This option will become available after the initial community review is approved.

1. Open Settings → Community plugins in Obsidian.
2. Select Browse and search for Continuous Journal Calendar.
3. Install and enable the plugin.

Manual installation

1. Download main.js, manifest.json, and styles.css from the latest release.

2. Create this folder inside your vault if it does not exist:

   <vault>/.obsidian/plugins/continuous-journal-calendar/
   

3. Copy the three downloaded files into that folder.

4. Reload Obsidian.

5. Open Settings → Community plugins and enable Continuous Journal Calendar.

Getting started

1. Enable the plugin.
2. Open Settings → Continuous Journal Calendar.
3. Set 主日记文件 (Master note) to the Markdown file that contains your continuous journal.
4. Confirm the 日记区域标题 (Journal heading) used in that file.
5. Use the calendar icon in the left ribbon to open the sidebar calendar.
6. Click any date to jump to or create its section.

If the configured master note does not exist, the plugin creates it the first time you click a date.

Settings

Setting	Default	Purpose
主日记文件 (Master note)	📓日常记录.md	Markdown file that stores all dated sections.
日记区域标题 (Journal heading)	📖 日记	Level-two heading under which new sections are inserted.
每周从星期一开始	Enabled	Controls the first weekday shown by the calendar.
启动时打开日历	Enabled	Opens the calendar in the left sidebar after the workspace loads.
新日期模板	Date and important-progress heading	Markdown inserted for a missing date. Supports {{date}}.

Commands

Open the Obsidian command palette to use:

• 打开单文件日历 — opens the calendar sidebar.
• 在主日记中打开今天 — jumps to or creates today's section.
• 按日期整理主日记 — repairs the journal timeline from newest to oldest.

Sorting only reorders complete dated blocks. The contents inside each block remain unchanged. As with any operation that modifies notes, keeping a normal vault backup is recommended.

Calendar indicators

• Entry indicator: the date has a recognized section in the master note.
• Task indicator: that section contains at least one unchecked Markdown task such as - [ ] Follow up.

Privacy and security

Continuous Journal Calendar works entirely inside your Obsidian vault.

• No account is required.
• No telemetry or analytics are collected.
• No network requests are made by the plugin.
• No files outside the vault are accessed.
• No advertisements or dynamic remote code are used.

The source code is available under the MIT License.

Compatibility

• Minimum Obsidian version: 1.13.0
• Supported platforms: desktop and mobile
• Required community plugins: none

Development

Requirements:

• Node.js 18 or later
• npm

git clone https://github.com/sapplex-sz/continuous-journal-calendar.git
cd continuous-journal-calendar
npm install
npm run dev

Run linting, type checks, tests, and the production build:

npm run check

Release packages must include main.js, manifest.json, and styles.css.

Contributing

Bug reports and focused pull requests are welcome. Please read CONTRIBUTING.md before contributing.

When reporting a problem, include:

• Obsidian version and platform;
• the steps needed to reproduce it;
• a small, anonymized example of the relevant note structure.

Do not upload private journal content. Use GitHub Issues for reports and feature requests.

中文说明

Continuous Journal Calendar 将侧栏日历与同一篇长期日记联动，不会每天创建一个新文件。

• 点击已有日期：打开主日记并跳转到对应日期。
• 点击空白日期：在同一篇主日记中按从新到旧的顺序创建日期段落。
• 记录标记：表示当天已有内容。
• 待办标记：表示当天存在未完成的 - [ ] 任务。
• 时间线整理命令：可以修复已有日期段落的错误顺序。
• 所有功能均在本地库内完成，不联网，也不收集任何数据。

官方插件库正在审核准备阶段；目前请从 Releases 下载三个安装文件进行手动安装。

License

Continuous Journal Calendar is released under the MIT License.