Calendar

Calendar placement

Display in the left or right sidebar.

  • Left sidebar (“left-sidebar”)
  • Right sidebar (“right-sidebar”)

Default:

  "calendarPlacement": "left-sidebar"

Sync mode:

  "syncModes": {
    "calendarPlacement": "synced"
  }

Disabling sync mode will set calendarPlacement to "local".

My settings

I set this to "right-sidebar".

Confirm before creating new note

Show a confirmation dialog when creating a new daily note.

Default:

  "calendarConfirmBeforeCreate": true

Appearance

Locale

Controls week numbering and first day of the week.

Default:

  "calendarLocale": "system-default"

Weekend days

Show weekend days with a different background color.

  • None (“none”)
  • Saturday and Sunday (“sat-sun”)
  • Friday and Saturday (“fri-sat”)
  • Thursday and Friday (“thu-fri”)

Default:

  "calendarWeekendDays": "sat-sun"

Month name format

Full or short month name when the year is hidden.

  • January (full) (“full”)
  • Jan (short) (“short”)

Default:

  "calendarMonthHeadingFormat": "full"

Release history:

  • 2.5.2: This setting was implemented.

Highlight today’s date

Highlight today’s date with a background color and bold text.

Default:

  "calendarHighlightToday": true

Show feature image

Display feature images for notes in the calendar.

Default:

  "calendarShowFeatureImage": true

Show week number

Add a column with the week number.

Default:

  "calendarShowWeekNumber": false

My settings

I set this to true.

Show quarter

Add a quarter label in the calendar header.

Default:

  "calendarShowQuarter": false

My settings

I set this to true.

Single pane placement

Where the calendar is shown in single pane mode.

  • Below panes (“below”)
  • Navigation pane (“navigation”)

Default:

  "calendarLeftPlacement": "navigation"

Sync mode:

  "syncModes": {
    "calendarLeftPlacement": "synced"
  }

Disabling sync mode will set calendarLeftPlacement to "local".

My settings

I set this to "below".

Weeks to show in left sidebar

Calendar in the right sidebar always displays the full month.

  • 1 week (1)
  • 2 weeks (2)
  • 3 weeks (3)
  • 4 weeks (4)
  • 5 weeks (5)
  • Full month (6)

Any number set in the JSON file that is not 1-6 shall be ignored in favor of the default value, 1.

Default:

  "calendarWeeksToShow": 1

Sync mode:

  "syncModes": {
    "calendarWeeksToShow": "synced"
  }

Disabling sync mode will set calendarWeeksToShow to "local".

Show year calendar

Display year navigation and month grid in the right sidebar.

Default:

  "calendarShowYearCalendar": true

Release history:

  • 2.5.2: Yearly calendar months now longer show “(n)” suffix, instead they show the same circles as daily notes (filled circle for notes, hollow circle for tasks). The yearly calendar month outline now always follows the active month.

Calendar integration

Daily note source

Source for calendar notes.

  • Daily notes (core plugin) (“daily-notes”)
  • Notebook Navigator (“notebook navigator”)

Default:

  "calendarIntegrationMode": "notebook-navigator"

Root folder (vault profile)

Base folder for periodic notes. Date patterns can include subfolders. Changes with the selected vault profile.

Default:

      "periodicNotesFolder": ""

My settings

I set this to "Daily notes".

Daily notes

Default:

  "calendarCustomFilePattern": "YYYY/YYYYMMDD"

Template:

  "calendarCustomFileTemplate": null

My settings

I set this to "YYYY/[Quarter] Q/MMMM/[Week] WW/YYYY-MM-DD".

Weekly notes

Default:

  "calendarCustomWeekPattern": "gggg/[W]ww"

Template:

  "calendarCustomWeekTemplate": null

My settings

I set this to "YYYY/[Quarter] Q/MMMM/[Week] ww".

Monthly notes

Default:

  "calendarCustomMonthPattern": "YYYY/YYYYMM"

Template:

  "calendarCustomMonthTemplate": null

My settings

I set this to "YYYY/[Quarter] Q/MM MMMM/MM MMMM".

Quarterly notes

Default:

  "calendarCustomQuarterPattern": "YYYY/[Q]Q"

Template:

  "calendarCustomQuarterTemplate": null

My settings

I set this to "YYYY/[Quarter] Q".

Yearly notes

Default:

  "calendarCustomYearPattern": "YYYY"

Template:

  "calendarCustomYearTemplate": null

My settings

I set this to "YYYY/YYYY".