Skip to content

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 Friday

ask 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.

  • 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.