Appearance
Journals
A journal is an ordinary page carrying a date. There is no journal table, no journal block type, and — this is the part that matters — the timeline never buckets anything by a journal's date.
Today's journal
The sidebar's Today's journal resolves today to its page and creates it on first use. That is all the mechanism there is, and it is enough: what makes the habit work is only that "today" resolves to the same page every time, so writing into it accumulates somewhere findable.
The date comes from your browser, not the server. "Today" is a question about the reader's calendar, and a server in another time zone answers it wrong for half of every day.
Two people pressing the button at the same moment get the same page — a partial unique index in the database makes two journals for one day impossible rather than unlikely.
A journal for another day
The sidebar offers today and only today. To make a journal for a different date, ask the API for it:
bash
curl -X POST http://localhost:3211/api/journals \
-H 'content-type: application/json' \
-d '{"date":"2014-03-12"}'It appears in the page tree marked with ◷, titled by its date. Creating one requires permission to create pages in the workspace, and counts against the page quota if there is one.
What a journal opens with
An empty journal offers a template, Daily journal unless you or the workspace chose another. Nothing is written until you press it.
Above the writing, one line says what is due that day and what is overdue, and today's says which Taskflow steps are yours now and how many suggested edits wait for you. Press it to see each one. The same line leads to the week's and the month's note.
Weeks and months
A week's note (2026-W44) and a month's note (2026-10) work the way a journal does: a page titled by its period, made the first time it is opened, one per period. Open them from the journal's line, or This week's note and This month's note in the command palette. Each lists the tasks planned for its period.
A note's period is exported as journalPeriod in its frontmatter and read back on import. A merge-back never changes it, just as it never changes a journal's day.
Filed under, versus written on
Write into a journal dated three months ago today, and:
- the block is filed under that journal — it is on that page, and that is where you will find it;
- the block was written today — and the timeline reports it under today, saying
filed under 2014-03-12beside it.
Every journal-file tool would date that writing to March, because the file it landed in is named after March. There is nowhere else for the fact to live.
Three dates, kept straight
They answer different questions, and only the first is derived:
| Where it lives | What it says | Who decides | |
|---|---|---|---|
| the op's wall time | the log | when this was written | the server's clock |
| a page's journal date | the page | which day this page is the journal for | the author, once per page |
| a block's declared date | the block | which day this item appears under | the author, per block |
A journal date is about filing: it makes a page findable as "today", and it is unique per day. A declared date is about placement: it puts one item on a day in the reading view without moving the note it lives in.
Neither is a claim about when anything was written, which is why neither can move the first row.