A note that uses every medium
A useful note should choose the smallest representation that makes the idea easy to recover. Prose explains intent; tables compare; equations compress; diagrams expose structure; code removes ambiguity.
Comparison table
Section titled “Comparison table”| Medium | Best for | Avoid when |
|---|---|---|
| Prose | Context and causal explanation | A precise relationship fits one equation |
| Table | Comparing a fixed set of dimensions | Sequence or topology matters |
| Diagram | Flow, boundaries, and ownership | Decoration is the only purpose |
| Code | Exact executable behavior | Pseudocode communicates more clearly |
Highlighted code
Section titled “Highlighted code”int clamp_int(int value, int low, int high) { if (value < low) return low; if (value > high) return high; return value;}Inline math keeps a relationship close to its sentence: the arithmetic mean is .
A block gives the model room to breathe:
Diagram
Section titled “Diagram”Click the diagram to open the image inspector. Use the mouse wheel or controls to zoom, then drag to pan.
The editable source is committed beside the SVG as garden-architecture.drawio; exporting it is deliberately manual.