Agent skill · writing content · aradotso
mdv-markdown-visualization
MDV — Markdown superset for documents, dashboards, and slides with embedded charts, KPI stats, and data visualizations exported to HTML or PDF.
Why this skill is useful
Provides specific commands and patterns for creating and exporting visualized markdown documents that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
MDV Markdown Data & Visualization Skill by ara.so — Daily 2026 Skills collection. MDV is a Markdown superset (.mdv files) for writing reports, dashboards, and slide decks in a single workflow, then exporting to self-contained HTML or PDF. It extends CommonMark with four additions: YAML front-matter, fenced visualization blocks, ::: containers for layout, and auto-generated tables of contents. Installation & Setup CLI Commands File Structure Document Anatomy Every .mdv file has three zones: 1. YAML front-matter — metadata, theme, named styles, dataset refs 2. Markdown body — standard CommonMark prose 3. Fenced blocks & containers — charts, stats, callouts, columns YAML Front-Matter Available Themes Theme Best for ------------- ---------------------------------- report Long-form documents, articles dashboard KPI cards, dense data layouts slides Presentations, slide decks minimal Clean, unstyled output Fenced Visualization Blocks Stat / KPI Cards stat label, value, delta Total revenue, $2.06M, +14% New customers, 1,238, +8% Churn rate, 2.1%, -0.3% Active accounts, 9,842, +5% The stat block renders a row of KPI cards. Columns: label, value, delta (optional). Charts All charts use markdown markdown Bar chart from referenced dataset Line chart with multiple series Pie chart Scatter plot markdown markdown markdown ::: toc ::: markdown ::: callout This is an important note rendered in a highlighted box. ::: ::: callout type=warning Watch out — this may have side effects. ::: ::: callout type=danger Do not run this in production. ::: markdown ::: columns ::: col Left column content, charts, or stats here. ::: ::: col Right column content. ::: ::: markdown ::: highlight This paragraph uses the highlight named style from front-matter. ::: ::: danger Critical warning styled with the danger named style. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/mdv-markdown-visualization