Block page
A Block page property holds blocks from top to bottom: paragraphs, headings, lists, photos, charts and @-mentions.
Example: a Diary collection has one Number and three Block page properties.
| Property | Type |
|---|---|
| Mood | Number |
| Liked today | Block page |
| Didn’t like | Block page |
| Grateful for | Block page |
Rules
- A new collection starts with one Block page property called “Page”. You can rename it, remove it or add more.
- Each Block page property is its own field: its own place on the card, its own search results.
- The Title is not a Block page. Every entry has one built-in Title (see System fields).
- The blocks keep their order, from top to bottom. To put blocks side by side, use a Columns block.
What it can hold
| Kind | Blocks | Example |
|---|---|---|
| Writing | paragraph, heading, list (bulleted, numbered, checklist), quote, callout, divider, code, mention | “Long run before work.” |
| Media | image, embed | a photo, stored once in Attachments/ |
| Data | Chart, View, Entry, Columns, HTML | a chart of steps per day |
Every block and its settings are on Blocks and charts.
- Type
/to list the blocks and pick one. - Drag a block by its handle to move it. Hold it over a closed toggle for half a second: the toggle opens, and the block drops inside it.
- A picture whose file is not on this computer shows a grey box with its name and Retry. Example: “This picture is not on this computer: hill.jpg”. Retry asks for the file again.
- An embed (a YouTube video, for example) shows its name and its link until the player loads, and stays that way when it cannot load (offline). A picture whose address is a video page shows as that link, never a broken picture.
- An Entry block shows another entry as a link, as its card, or as one property (a note’s Block page, a dashboard’s Dashboard property). Edits inside it change the real entry. See Entry block.
- An entry tab or an Entry block can show this Block page alone, as one property: only its blocks. Example: the diary day “28 Oct”, property Liked today, shows only that text. A Block page shown this way in a block follows the embed limits: at most 3 levels, and no loops.
- The
/menu also makes new entries: New note makes a note with this entry as its Parent, and puts a link to it where you typed. See The slash menu.
Mentions
An @-mention is a link to another entry. It never makes that entry a child. The mentioned entry shows “Mentioned in: 19 Oct” on its entry page (a backlink, a link that points back). Its file is not rewritten when someone mentions it.
How edits merge
A Block page merges word by word. If you edit the first line on your phone and the last line on your laptop while offline, both edits are kept. Two people in a shared space can write in the same Block page at once in the same way. (The merge uses Loro, a library for text that several devices edit at once.)
Change it to a Dashboard
You can change a Block page property into a Dashboard. Every block is kept: each block becomes a full-width tile, in the same order. A Columns block becomes tiles side by side. See Changing a property type.
Settings
| Setting | What it does |
|---|---|
| Name | The name you see, for example “Grateful for”. |
How it shows
| Place | Shows |
|---|---|
| Card | the first lines, if the card design places it |
| List and table row | the first line |
| Entry page | every block, in the editor |
| A tab or an Entry block that shows it as one property | every block, in the editor, as on the entry page |
The editor
A Block page is edited with Kaizendex’s own block editor. It works like Notion’s and wears your theme.
- Type anywhere. Each letter shows at once.
- Drag a block by the six dots at its left. A line shows where it will land. There is no plus icon.
/lists the blocks.@mentions a page or a date.[[links a page.:picks an emoji.- Select text to see the format bar: bold, italic, underline, strike, code, link, colour.
- Shortcuts are Notion’s. Examples:
Ctrl+Bbold,Ctrl+Klink on selected text,Ctrl+Shift+1Heading 1,TabandShift+Tabto nest,Ctrl+Zundo,Ctrl+Shift+Zredo. - Paste text, a web page or a Notion page: headings, lists and links are kept.
Ctrl+Shift+Vpastes plain text. After a paste of several blocks the caret sits at the end of the last one, so the next paste goes after it. Ctrl+Ztakes back whole words. Fast typing is grouped into steps, as in Notion; a step ends at a pause of about a second, or between two words, never inside a word.- Leave a code block at the end of a page with
↓on its last line (orEsc, then↓): a new text line opens under it.Enterinside a code block types a new line of code. Ctrl+Ffinds words on the page. A small bar opens at the top right:EnterandShift+Enter(or the arrows) step through the matches,Esccloses it. It works on every page of the app, not only in a Block page.- Paste or drop a picture or a file: it is stored with the entry and shows as a picture or file block.
- A view, a chart or an entry inside a page is live: you can click and edit in it.
How a page is saved
- Saving is automatic. The page is stored about half a second after you stop typing, and at once when you click outside the page, switch away, close it or quit the app. Quit waits for the save.
- Nothing is overwritten. If the page changes somewhere else while you type (an AI agent,
kzx, another pane), both changes are kept. Changes in different lines are merged. If both changed the same line, both versions stay, yours first. Example: you add a last line while an agent renames the heading; the page has both. - An Undo made elsewhere shows at once. Example:
kzx undotakes back your last save; the open page shows the older text. - A page you only open is never rewritten. Its file stays the same, byte for byte. So does a page where you typed something and took it back.
- An edit changes only its own words. Example: you add a word to a line that has
**bold**in it. In the file only that word is new: the line keeps its own style (its bullet sign, its bold, its links), and every other line keeps its exact spacing and spelling. - Every save can be undone.
Ctrl+Zin the page takes back your last edits. Saves you make while you keep typing (less than 10 seconds apart) are one step in the entry’s Version history (page menu •••), andkzx undotakes that step back whole. Example: you write a paragraph in a minute; one undo takes the paragraph. - Text the editor cannot read as a block is kept as it is. It shows as a grey box of source text. You can edit around it, and its bytes are never changed. Example: a line of raw HTML from another app.
- A link to a file beside the note (
[notes](docs/notes.md), from a note you brought in from a folder) stays a link in the file. A click opens the note of that name in the app (here, a note called “notes”). If there is no such note, a short message says so and nothing opens. - Only web and email links (
https://,http://,mailto:) open in your browser or mail app. Nothing else ever leaves the app: not a file on your computer, not a network share, not a script. - Some older notes hold a file name that the old editor turned into a web address, for example
[README.md](https://README.md). A click treats it as the file name it was and looks for the note “README”. - Typing a file name in the link box (
Ctrl+K), such asREADME.md, links the file, not a website. A site name, such asexample.com, becomeshttps://example.com.
In the folder
All Block page properties of an entry share one markdown file. A marker line starts each one.
---title: 19 Octmood: 7---<!-- document: Liked today -->Long run before work.
```kzx-chart{ "version": 1, "kind": "bar", "collection": "Activity", "dateFilter": "thisEntry" }```
<!-- document: Grateful for --><!-- columns --><!-- column -->![[Attachments/2026-10/hill.jpg]]<!-- column -->Jonas helped with the sync plan.<!-- /columns -->- The markers are HTML comments, so Obsidian and other markdown apps hide them.
- With only one Block page property and no Dashboard, the body is plain markdown with no marker.
- Writing and media blocks are plain markdown.
- A data block (Chart, View, Entry, HTML) is a code block whose language is
kzx-chart,kzx-view,kzx-entryorkzx-html. It holds the block’s settings as JSON. Obsidian shows it as code, and nothing is lost. - A Columns block is written with the marker lines
<!-- columns -->,<!-- column -->(one per column) and<!-- /columns -->. - What markdown cannot hold (a toggle, a colour, a bookmark card, a table’s settings, a column’s
width) is a small note at the end of the block’s line:
<!-- kzx {"isToggleable":true} -->. Blocks inside a block that is not a list sit between<!-- children -->and<!-- /children -->. So every block comes back exactly as it was saved. - A file you edit in another app is read safely: only known kinds of blocks, named colours and
safe links (web, email, phone and Kaizendex links, and a plain path to a file beside the note, such as
docs/notes.md). A link that is not safe keeps only its words. - Renaming a Block page property rewrites its markers.
- A missing or broken marker goes to
problems.md. No text is ever lost. - Mentions are
[[links]]in the text:[[Notes/Essay One]], or[[Notes/Essay One|my essay]]when the mention shows other words. Reading the file gives back the same mentions.
AI, formulas and search
- AI can read one Block page property alone: “what was I grateful for this month?”
- Formulas can use it as text:
length(prop("Grateful for")). - Search finds words in each Block page property separately.