13 Calendar 📅

"I know I wrote that note last week... where is it?" Let the calendar panel find your notes by date, and lay out today's to-dos on a timeline while it's at it!

← Home: ObsiKO 101

Where do I open it? 🔭

• Open the right sidebar panel and pick Calendar from the navigation. → A Tour of the Screen

Today's diary — daily notes ✍️📅

• Click the calendar+ button in the calendar panel header (next to the ✕ close button) to instantly create and open today's dated note (like 2026-06-28.md)! If it already exists, it just opens that note.
• You can call up the same thing from the command palette (Mod+P) with "Open today's note."
• You can choose which folder these notes are saved to in Settings → Daily Notes Folder (leave it blank for the vault root). Keep your daily records tidy in one place! → Settings & Themes

What does it show? 🗓️

• Every document in your vault is scattered across the calendar by its creation date (or modified date). Days you wrote something show a marker, so you can spot them at a glance.
• Days with a task (to-do) get a marker too. Just glancing at the calendar tells you what's going on that day!
• Today's date is selected by default.
• Ledger net-amount badges too 💰: if you keep a Ledger, a net-amount badge for that day appears in the corner of each date cell — blue for income, red for expense (big amounts shown compactly, like 1.2M). Pick a date and that day's entry summary shows up too. If it feels busy, turn it off with Settings → Calendar → 'Ledger amount badges'.
• Project date spans show as bands 📏: notes with a start~due (deadline) in their frontmatter (like PARA's para: project) show that whole start-to-deadline period as a band — so you can see right on the calendar when to start and when it's due (and the same goes for the day/week/month calendars on the Dashboard!). → PARA

Try clicking around 👆

• Click a date → see the list of documents written (or edited) that day, plus that day's timetable!
• Click a month name → gather every document from that whole month!
• Click a year → pull up the entire year's documents at once!
• Click any document in the list to jump straight into the editor.

▲ Browse notes by date, and see today's to-dos laid out on a timetable at a glance.

Today's timetable ⏰

Pick a date and a timetable unfolds, laying out that day's tasks (to-dos) in chronological order.

• Timed tasks are lined up in time order, while tasks without a time are grouped at the top in an All Day slot.
• Tasks happening right now are highlighted in a box so it's easy to notice, "Oh, this is what I should be doing right now!"
• Hover over a task to see a tooltip with detailed info (due/start/scheduled date, priority, recurrence, ID/dependency, alarm, and more).
• Click the checkmark in front of any task to flip its status instantly. Right-click (or long-press) to bring up a menu for Mark done / Undo done / Cancel task / Open. (Your scroll position is preserved so the screen doesn't jump when you change a status!)
• Recurring tasks automatically reappear each day/week/month according to their set rule.

How do I add a task (to-do)? ✍️

A task is ultimately just one checkbox line in the body text (- [ ] Task). You can type it by hand, but the compose helper makes it much easier.

• In the editor, right-click (or long-press) → "Add task" to open a small composer.
• A few clicks there neatly assemble a to-do line with the info below, and it drops right into place at your cursor.
• Type & date: choose from Due 📅 / Scheduled ⏳ / Start 🛫 and set the date
• Time ⏰: start/end time (e.g. 14:00–15:30)
• Priority: 🔺 Highest · ⏫ High · 🔼 Medium · 🔽 Low · ⏬ Lowest
• Recurrence 🔁: pick a frequency (weekly/monthly/yearly) and tick specific days — pick every day of the week for daily, or just Mon–Fri for weekdays.
• Alarm 🔔: relative to start/end time — on time, 5/10/30 minutes before, 1 hour before (also 1 day before, relative to start) (see below)
• ID 🆔 · Dependency ⛔: for chaining tasks in order (see below)
• The finished line renders as a nicely formatted task card in the editor, and the same content shows up right away in the calendar's timetable too.

💡 A task isn't some special file — it's just a plain Markdown checkbox. That means it's compatible with Obsidian's Tasks syntax, and the calendar will scoop it up and display it no matter which note you wrote it in.

Never miss it — alarms 🔔

Set an alarm on a timed task, and a notification will go off at the scheduled time.

• In the composer's Alarm 🔔 field, just pick something like "10 minutes before" or "1 hour before" — that's it!
• On iPhone/iPad, alarms fire even with the app closed (device notification permission required).
• On desktop/web, alarms fire while the app is open. (Please allow browser/system notification permission once.)

Chaining tasks in order (ID & dependency) 🔗

Use this feature when there's an order to things — "I need to finish this before I can start that!"

• Attach an ID 🆔 (e.g. design1) to the earlier task,
• then in the following task's Dependency ⛔ field, pick that ID to link them,
• and ObsiKO understands the relationship between the two, flagging any task that's still blocked (its predecessor isn't done) with a 🔒 marker.
• Like a wiki link, you can pick the ID from a list of IDs you've already created, so there's no risk of typos. (For easy lookup, we recommend giving IDs readable names!)

Gathering to-dos in one place (Tasks queries) 🔍

Pull to-dos scattered across your vault together into one note, filtered however you like. Just open a tasks code block and add your conditions one line at a time.

not done
due before next week
sort by priority

• Filters: not done, done, due before <date>, priority is high, path includes <folder>, tag includes #project, and more
• Combining: group conditions with AND / OR / NOT / XOR and parentheses, like (not done) AND (due before tomorrow) or NOT (path includes archive); regex is fine too, like description regex matches /pattern/
• Sort, group, limit: sort by due, group by folder, limit 20
• Set a global filter/global query in Settings to apply a shared condition across every task/query in the vault at once. → Settings & Themes

Compatible with Obsidian's Tasks plugin syntax. Queries you used in Obsidian will work here just as well.

Putting a calendar inside a note (```calendar block) 🗓️

"I want to see the schedule right here in this project note" — open a calendar code block in your note and a calendar appears right there. It draws from your whole vault's events, so there's nothing to copy over.

```calendar
view: month
```

• Five ways to look at it: switch with the Month / Week / Day / Year / Timeline buttons in the calendar's header, and move around with ‹ Today › (it steps by a month, a week, or a day to match the view).
• Your chosen view is saved into the note 📌: pressing a button rewrites the block's view: line. So it stays that way when you reopen the file, on your other devices, and even when the note sits as a card on a mind map. (It's an ordinary text edit — ⌘Z undoes it.)
• Click a day cell to narrow from month → that week → that day. Click an event to jump to that line in its note.
• Timeline groups projects with the tasks inside their notes as bars (projects fold and unfold).
• Double-click an empty spot in the block to open the source (the settings lines).

Lines you can write (all optional):

The Calendar card on the Dashboard is the very same calendar — learn one and you know the other.

Viewing alongside external calendars (ICS subscription) 🌐

You can overlay events from your Google/Apple Calendar onto the ObsiKO calendar too.

• Public holidays are on by default 🎌: with no setup, a country's public holidays appear on the calendar as red dots. At first the country is chosen automatically to match the app language (Korean → South Korea, English → USA, Japanese → Japan), and you can pick a country yourself (26 of them) or turn it off ('Off') in Settings → Calendar → "Public holidays". It's Google's public holiday calendar, so it's separate from any subscriptions you add.
• Paste your calendar's private address (ICS) into Settings → Calendar, and those events show up alongside yours in read-only mode.
• Subscribed events also appear on the Dashboard — its calendar, weekly schedule, and Calendar card (📅 read-only, refreshed every 10 minutes).
• Recurring events are handled properly: daily/weekly (with weekdays)/biweekly/monthly/yearly rules, plus deleted or moved occurrences and cancelled events, computed the same way calendar apps do. Multi-day events span their whole range.
• You can also export your vault's tasks as .ics to bring them into another calendar app.

Focus & writing records too ⏱️

• Under the calendar, the Focus Log shows how long you stayed immersed with the Focus Timer and how much you wrote with the character counter, all broken down by date! Check "how focused was I that day?" right from the calendar.

Make it your own ⚙️

• Sort by: choose whether documents are grouped by creation date or modified date.
• Week start day: whichever's more comfortable — Sunday or Monday!

← Previous: Knowledge Packs · Home · Next: Focus Timer (Pomodoro) →