MDV — Markdown Data & Visualization
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 . ::: 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.
Quick look
--- 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.
Getting started
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
... continue reading