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 scalerevisit this at scale
Settings
| Setting | Type | Required | Default | Meaning |
|---|---|---|---|---|
side | right · left | no | right | Not built yet: does nothing for now. Which margin channel. right is default; left uses the left channel (requires @page margin: left or both). |
align | top · middle · bottom | no | top | Not built yet: does nothing for now. Vertical alignment against its anchor block — matters when the anchor is tall, like a diagram. |
at | string | no | — | 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. |
loose | boolean | no | false | Not 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
The fan-out here is the risky part.