Notes in the margin
Most of what I've learned from books came from the margins. Not the printed text, but what someone scribbled beside it: a question mark, a date, a word that's half argument and half reminder.
Margin notes work because they're subordinate. They don't interrupt the sentence; they wait beside it. You can read the page without them, and then read them as a second, quieter layer.
That's the rule I try to keep on this site. An annotation should be secondary to the writing, never a substitute for saying the thing clearly in the first place.
Three kinds of mark
There are really only three gestures worth borrowing from paper:
- The highlight: this matters, come back to it.
- The underline: read this word carefully.
- The bracket and note: here's what I thought when I read this.
Each one costs the reader a little attention. Used once in a while, they're a voice. Used on every paragraph, they're noise, and the page starts to look like a revision guide.
Using them in a post
The components are available in every MDX file without an import:
Some words get <Highlight>a highlighter pass</Highlight>.
<MarginNote note="a short aside">
The paragraph being annotated.
</MarginNote>Keep notes under a dozen words. If it needs more, it's a footnote.1
Footnotes
-
Or a paragraph. Usually a paragraph. ↩