Skip to content

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.

PageBlocks
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

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 blockWhat happens to a block written inside it
@panel, @columns, @callout, @decision, @metric, @persona, @risk, @assumptionDrawn 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, @timelineDrawn 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, @iconRead 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.

SettingTypeRequiredDefaultMeaning
idstringno—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.
widthauto · column · wide · full · landscapenoautoHow 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.
iconstringno—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_atinline · margin · cornernoinlineNot 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.