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:
- YAML front-matter for title, theme, named styles, and dataset references.
- Fenced blocks for data/visuals:
```chart type=bar x=region y=sales. :::containers for styled regions and layout:::: callout/::: columns.:::tocfor 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 # Render an example node packages/mdv-cli/dist/index.js render examples/09-full-report.mdv # Or: live preview with auto-reload node packages/mdv-cli/dist/index.js preview examples/09-full-report.mdv
See docs/getting-started.md for a walkthrough.
- Getting started — install, author your first file, see it rendered.
- Syntax reference — front-matter, fenced blocks,
:::containers. - Charts & stats — every visualization type with all options.
- Data — inline CSV / JSON / file-referenced datasets.
- Themes & styles — built-in themes and how to define named styles.
- CLI —
render,preview,export --pdf. - VS Code extension — side-by-side live preview.
- Publishing the VS Code extension — Marketplace workflow.
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.