Visualize

Create data visualizations for the surface where they will actually be read. Three engines:

• Markdown — .md files (or .html with mermaid.js bundled) that render inside pull requests, READMEs, tickets, Notion, Slack, wiki posts.
• Vega — declarative JSON specs rendered in a standalone HTML wrapper. Default for browser-runnable charts.
• D3 — imperative JavaScript with full DOM control, keyboard navigation, and ARIA on individual marks. Use when Vega cannot express what you need.

Every browser output is a standalone HTML file — no build step, no server, no dependencies beyond CDN.

Core Principles

These principles determine whether a visualization communicates or decorates. They apply to every chart, regardless of engine or chart type. When in doubt, return to these.