- section
- visualization
- created
- 2026-07-26
- updated
- 2026-10-30
Visualization
Visualization
Visualization is how track turns note content into something you see — not just prose and links. It splits into five families, each with its own page:
- Diagrams — Mermaid (flowcharts, sequence, class, state, Gantt, and every other type it knows),
Graphviz DOT graphs, D2 diagrams, and draw.io files rendered with draw.io's own viewer, written
inline or kept as a
.mmd/.dot/.d2/.drawioattachment. - Mindmaps — a note's heading tree, or an indented outline, drawn as a tree by a small built-in renderer.
- Charts — statistical charts (line, bar, scatter, heatmap, timeline, …) rendered by
track renderfrom a declarative View Spec over the Canonical Data Model. Embed one in a note as a.viewspec.jsonasset; track resolves it at build time and the published page draws an interactive chart. See missing observations for gaps, real zeros, rankings, and gauges when a measurement is unavailable. - Embeds — rich media from a standalone
: YouTube players, Twitter/X posts, PDF decks, image URLs, and Open Graph link cards. - Maps — a
mapfence with center coordinates, zoom, tile type, and wiki-linked markers, drawn as a slippy map.
All are driven by ordinary Markdown — a fenced block or an image link on its own line — so a note stays
plain text and portable, while the Web workspace and the static export (CLI export-site)
render the visuals identically.