Write documents, dashboards, and slides in a Markdown superset. Add charts, KPI cards, tables, and styled regions with nothing more complicated than fenced code blocks and named styles.
.mdv is strict CommonMark plus four additions:
```chart type=bar x=region y=sales.::: containers for styled regions and layout: ::: callout / ::: columns.::: toc for an auto-generated table of contents.No selectors, no classes, no expressions, no code. Themes provide defaults, named styles give reusable looks, the renderer does the rest.
--- title: Q1 Report theme: report data: sales: ./data/sales.csv ---
::: toc :::
# Q1 Results
```stat label, value, delta Total revenue, $2.06M, +14% New customers, 1238, +8% ```
```chart type=line data=sales x=month y=revenue series=region yFormat=currency title="Monthly revenue" ```
Renders to self-contained HTML (charts are inline SVG, no JS runtime) and PDF. Lives inside VS Code via a side-by-side preview.
git clone <repo> mdv cd mdv npm install npm run build
node packages/mdv-cli/dist/index.js render examples/09-full-report.mdv
node packages/mdv-cli/dist/index.js preview examples/09-full-report.mdv
See docs/getting-started.md for a walkthrough.
::: containers.render, preview, export --pdf.examples/ contains 10 sample files covering every feature. Rendered HTML is in examples/out/.
v1, pre-release. Runs on Node ≥ 20. See docs/superpowers/specs/2026-04-18-mdv-format-design.md for scope, non-goals, and roadmap.