Skip to content
Tech News
← Back to articles

Show HN: MDV – a Markdown superset for docs, dashboards, and slides with data

read original get Markdown Dashboard Templates → more articles
Why This Matters

MDV introduces a streamlined way for developers and data professionals to create rich, interactive documents, dashboards, and presentations using a Markdown superset. Its simplicity and compatibility with existing tools like VS Code make data visualization more accessible and efficient, potentially transforming how data is communicated across the industry.

Key Takeaways

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