Skip to content

Date Notes

Date Notes allow you to leverage your existing daily notes structure. You can enable Date Notes globally in the settings, under Date Notes. For example, Breadcrumbs can add edges from 2022-01-01 to 2022-01-02, to 2022-01-03 using the field you specify.

flowchart LR
	1(2022-01-01) -- next --> 2(2022-01-02) -- next --> 3(2022-01-03)

[!TIP] Under the hood, Breadcrumbs takes the date of the current note and adds one day to it. So the field you choose should reflect the “next” nature of this builder (as opposed to pointing to the date before the current one).

  • Enable: Toggle Date Notes on or off
  • Field: Choose the field to use for the edges
  • Date Format: Choose the date format you use for your daily notes (e.g. YYYY-MM-DD)
  • Stretch to Existing: If there is a gap from one day to another, should the next note be the unresolved one in one day or should it “stretch” to the next resolved (existing) note?

In addition to daily edges, Date Notes can build a temporal hierarchy by connecting daily notes up to their containing week, month, quarter, and year notes. Each period level is configured independently under Settings → Date Notes → Period Notes.

flowchart LR
	1(2024-01-15) -- up --> 2(2024-W03) -- up --> 3(2024-01) -- up --> 4(2024-Q1) -- up --> 5(2024)

Each period level (Week, Month, Quarter, Year) has its own sub-section with the following settings:

  • Enabled: Toggle this period level on or off

  • Date Format: The Luxon format matching the filename stem of your period notes

    PeriodDefault formatExample filename
    Weekkkkk-'W'WW2024-W03
    Monthyyyy-MM2024-03
    Quarteryyyy-'Q'q2024-Q1
    Yearyyyy2024
  • Folder: Vault folder containing the period notes. Leave empty to match notes anywhere in the vault.

  • Next Field: The field used for sequential edges between period notes of the same level (e.g. 2024-W032024-W04)

  • Up Field: The field used for containment edges from a child note up to its period note (e.g. 2024-01-152024-W03)

[!TIP] Period levels are independent — you can enable only Month and Year if you don’t use weekly or quarterly notes.