Annotation Gallery
Annotation Positions
Annotations can be placed at any edge or corner of the terminal viewport. All examples below use the default medium width and callout style.
Position: Top-Left
Position: Top
Position: Top-Right
Position: Left
Position: Right
Position: Bottom-Left
Position: Bottom
Position: Bottom-Right
Annotation Widths
The width field controls how wide an annotation can grow as a fraction of the player viewport. All examples below use top-right position and callout style.
Small (25%)
Medium (50%) — Default
Large (75%)
Choosing Settings
| Goal | Recommended |
|---|---|
| Brief label next to code | position: right, width: small |
| Step explanation avoiding left-aligned output | position: top-right, width: medium |
| Long description with room to breathe | position: top, width: large |
| Warning banner across the top | position: top, width: large, style: highlight |
| Subtle aside | position: bottom-right, width: small, style: subtle |
YAML Example
annotations:
- at: 2.0
duration: 3.0
text: This step installs all dependencies
position: top-right
style: callout
width: largeAvailable positions: top-left, top, top-right, left, right, bottom-left, bottom, bottom-right.
Available widths: small (25%), medium (50%, default), large (75%).