All blocks
Jotstak has 28 blocks, and they come in 18 looks. Several blocks
share a look: @risk and @decision are both panels, with a different label
and colour filled in for you. Learn the looks; the named blocks are
shorthand. 3 of them are planned and not built yet:
@footnote, @doodle, @icon.
Everything here is optional. A .jot file is Markdown with more it can do,
so a file using none of it still renders.
| Page | Blocks |
|---|---|
| Panel | @panel, @decision, @risk, @assumption, @persona, @metric, @callout |
| Columns | @columns |
| Quote | @quote |
| Margin notes | @note |
| Headings | @heading, @cover |
| Lists | @bullet, @numbered |
| Dividers | @divider, @pagebreak |
| Tables | @table |
| Document metadata | @meta |
| Trees | @tree |
| Matrix | @matrix |
| Timeline | @timeline |
| Journey | @journey |
| Star model | @star_model |
| Sticky notes | @sticky |
| Freeform | @doodle |
| Inline marks | @icon, @footnote |
| Page setup | @page |
What goes inside what
Section titled “What goes inside what”A block indented under another is drawn inside it, drawn below it, or read as text. Which one depends on the outer block:
| The outer block | What happens to a block written inside it |
|---|---|
@panel, @columns, @callout, @decision, @metric, @persona, @risk, @assumption | Drawn inside it, after its own content. In @columns, a block written under a column’s key: goes in that column, and one at the columns’ own indent becomes a column of its own. |
@bullet, @numbered, and Markdown’s - and 1. | Drawn inside the item it is written under: a point, then the figure that explains it, indented beneath. |
@table, @tree, @star_model, @journey, @matrix, @timeline | Drawn below it. A figure has nowhere inside it for another block, so a metric under a tree is under the tree, not in one of its nodes. |
@meta, @page, @heading, @divider, @pagebreak, @cover, @note, @quote, @footnote, @doodle, @sticky, @icon | Read as text. These hold words, not blocks. |
Some blocks belong to the page itself and never go inside another:
@meta, @page, @pagebreak, @cover, @note, @sticky.
A line of text inside any other block — a card’s key:, a node of a tree —
holds text too. A block cannot start there.
A block written somewhere it cannot go is never dropped silently: the editor underlines it and says where it can go instead.
Settings every block accepts
Section titled “Settings every block accepts”| Setting | Type | Required | Default | Meaning |
|---|---|---|---|---|
id | string | no | — | A name for this block, so a link can jump straight to it: #pricing-decision after the page’s address. Never shown on the page. |
width | auto · column · wide · full · landscape | no | auto | How much page this block takes. auto (default) lets the renderer decide: a figure stays in the text column if it fits, takes the full width if it doesn’t, and moves to a landscape page of its own if it still doesn’t. column keeps it in the text column, wide fills the text column, full spans the margin channel too, landscape gives it a landscape page. A figure pinned somewhere too small for it is scaled down to fit — never cut off. |
icon | string | no | — | Not built yet: does nothing for now. Optional Lucide icon name for this block. Nothing renders unless you set it — there are no automatic icons. Autocomplete suggests a fitting icon per primitive (see SUGGESTED_ICONS), but the choice is always yours. |
icon_at | inline · margin · corner | no | inline | Not built yet: does nothing for now. Where the icon sits. inline = immediately before the block’s title/first line. margin = out in the notebook margin channel, drawn larger, like a marginal doodle. corner = tucked into the card’s top corner (card primitives only; falls back to inline with a diagnostic otherwise). Only meaningful when icon is set. |