Skip to content

Margin notes

An annotation in the margin channel, beside the block it follows. The block it is attached to narrows to make room for it; every other block keeps the full width of the page.

Margin note in the handwritten typeface. It sits beside the last line written before it: after a list, beside the last point; after a paragraph, beside its last line. The lines beside it make room and take the full page width back below it. Beside a box — a card, a table, a diagram — the box narrows instead, since a box cannot wrap. Several notes stack in the order written; a note longer than its text makes the row taller rather than running into the next. On a narrow screen notes fold in under the block they belong to.

Holds text, not other blocks. Goes on the page itself, never inside another block. What goes inside what

@note revisit this at scale

revisit this at scale

Settings
SettingTypeRequiredDefaultMeaning
sideright · leftnorightNot built yet: does nothing for now. Which margin channel. right is default; left uses the left channel (requires @page margin: left or both).
aligntop · middle · bottomnotopNot built yet: does nothing for now. Vertical alignment against its anchor block — matters when the anchor is tall, like a diagram.
atstringno—Not built yet: does nothing for now. Anchor to a specific block by its id= instead of the preceding block. Lets you group notes together in source while still pointing at the right place.
loosebooleannofalseNot built yet: does nothing for now. Detach from any anchor — no tick rule. The note just flows in the margin at this point. For general asides about a whole section.
More examples
@decision title="Move to usage-based pricing" status=accepted
  context: Seat pricing punishes the teams who adopt fastest

@note
  The fan-out here is the risky part.

decisionaccepted

Move to usage-based pricing

contextSeat pricing punishes the teams who adopt fastest

The fan-out here is the risky part.