HN
Today

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

MDV introduces a clever Markdown superset designed for creating data-rich documents, dashboards, and slides, simplifying complex visualizations with plain text. It allows embedding charts, KPIs, and styled regions using straightforward fenced code blocks and YAML, eliminating the need for traditional coding. This project resonates with the HN audience by offering an elegant, developer-centric solution for structured content and data reporting.

14
Score
3
Comments
#6
Highest Rank
8h
on Front Page
First Seen
Apr 18, 5:00 PM
Last Seen
Apr 19, 12:00 AM
Rank Over Time
10766791113

The Lowdown

MDV (Markdown Data & Visualization) is a new open-source project introduced on Hacker News that aims to revolutionize how technical documents, dashboards, and presentations are created, especially those heavily reliant on data. It extends the familiar Markdown syntax to seamlessly integrate sophisticated data visualizations and structured layouts, all without writing traditional code.

  • Markdown Superset: MDV builds upon strict CommonMark, adding four key features: YAML front-matter for metadata and dataset references; fenced code blocks for embedding charts, KPI cards, tables, and statistics; ::: containers for styled regions and layout (e.g., callouts, columns); and a ::: toc for auto-generated tables of contents.
  • Simplified Data Visualization: The core philosophy is to remove complexity. Users specify visualization types (e.g., chart type=bar) and data parameters within fenced blocks, relying on themes and named styles to handle presentation. This approach eliminates selectors, classes, expressions, or custom code for visuals.
  • Output & Ecosystem: MDV renders to self-contained HTML (with inline SVG charts and no JavaScript runtime) and PDF. It boasts a VS Code extension that provides a side-by-side live preview, enhancing the authoring experience.
  • Getting Started: The project provides clear instructions for installation via npm, command-line rendering, and live previewing, along with comprehensive documentation covering syntax, charts, data handling, themes, and CLI usage.
  • Status: Currently in v1 pre-release, MDV requires Node.js version 20 or higher, with detailed specs and a roadmap available in its documentation. By offering a powerful yet simple plaintext approach to create dynamic, data-driven content, MDV positions itself as a valuable tool for developers and analysts looking for an efficient way to communicate insights without diving into complex web development or design tools.