Margin notes
A margin note is the thing you would write beside a paragraph in pencil: a
question for later, who to ask, the part that worries you. Write @note and the
text, on the line after the block it is about.
Pricing is the fastest lever we have, and the one we have pulled least.
@note ask Ana before Fridayask Ana before FridayPricing is the fastest lever we have, and the one we have pulled least.
ask Ana before Friday
For a longer note, put the text on the lines under @note, indented:
@decision title="Move to usage-based pricing" status=accepted
context: Seat pricing punishes the teams who adopt fastest
@note
Revisit in Q1. Finance agreed to a floor, not to this.decisionaccepted
Move to usage-based pricing
contextSeat pricing punishes the teams who adopt fastest
Revisit in Q1. Finance agreed to a floor, not to this.
Where it goes
Section titled “Where it goes”- Beside the last line you wrote before it. Written after a list, it sits beside the last point; after a paragraph, beside its last line. The lines next to it make room, and once it ends the text takes the full width of the page again.
- Beside a box — a card, a table, a diagram — the box narrows to sit next to it instead, because a box cannot wrap around anything.
- Several notes in a row stack, in the order you wrote them. A note longer than the text beside it makes that part of the page taller rather than running into what comes next.
- On a narrow screen there is no room for a margin, so a note moves in under the block it belongs to.
- In doc mode the note stays beside its block, set more quietly.
A margin note belongs to the page, so it cannot go inside another block. Write it at the left edge, straight after the block it is about.