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 / .drawio attachment.
  • 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 render from a declarative View Spec over the Canonical Data Model. Embed one in a note as a .viewspec.json asset; 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 ![alt](src): YouTube players, Twitter/X posts, PDF decks, image URLs, and Open Graph link cards.
  • Maps — a map fence 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.