markdown-html-skills
v2.10.3Convert long markdown files into world-class, single-file, lightly-interactive HTML. v2.10.3 completes the markdown-html/ domain — adds md-slides (slide-deck converter: arrow-key / Space / PgDn / Home/End / P keyboard navigation + presenter mode with split-view clock + notes + next-slide preview + URL-hash deep linking + @media print page-per-slide for PDF export) on top of md-review v2.10.2 (code-review: 2-col diff + severity-tagged margin annotations + WCAG-1.4.1 badges + mandatory named reviewer footer), md-document v2.10.1 (long-form: sticky TOC + scrollspy + search + code-copy + Prism.js autoloader), and the v2.10.0 foundation: markdown-html-orchestrator (context: fork; deterministic doc-type classifier; refuses < 100 lines per Shihipar; refuses without onboarding) + design-system (10-question onboarding wizard; WCAG-AA-validated 12-token palette; project > global > defaults precedence; MARKDOWN_HTML_NO_CONFIG=1 bypass). 15 stdlib-only Python tools (3 per skill across 5 skills), 15 references citing 5-7 sources each, 4 template/schema assets. Inspired by Thariq Shihipar's Claude Code HTML output essay (Medium, 2026). Outputs are single self-contained .html files; only externals are Google Fonts CSS and (opt-in per skill) Prism.js CDN. Domain complete.
by Alireza RezvaniMIT24.2kupdated 10 hours ago
Source
git clone https://github.com/alirezarezvani/claude-skillsClone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is markdown-html/ inside the repository.
Layout
├── .claude-plugin/plugin.json├── skills/markdown-html-orchestrator/SKILL.md├── skills/md-document/SKILL.md└── skills/md-review/SKILL.md
Skills3
Use when a user wants to convert any markdown file in their Claude project into a single-file, lightly-interactive HTML — long-form documents (specs, plans, RFCs, reports, explainers), code reviews with diffs and severity-tagged annotations, or slide decks. Triggers on "convert this markdown to HTML", "make this an HTML file", "turn this into an interactive document", "render this report as HTML", "PR writeup as HTML", "slides from this markdown". Forks context to route to one of three converter sub-skills (md-document, md-review, md-slides) based on a deterministic doctype classifier, after the user has run the design-system onboarding once. Refuses if input is under 100 lines (per Shihipar — markdown still wins below the threshold) or design-system isn't onboarded. Distinct from Anthropic's official Playground plugin (which is interactive prompt-tuning controls with sliders/knobs/prompt-copy-back) and from marketing/landing/ (which is a landing-page generator).
Converts long-form markdown (specs, RFCs, reports, plans, explainers) into a single-file, lightly-interactive HTML document with sticky TOC, scrollspy, search filter, code-copy buttons, and design-system-driven brand tokens. Triggers when the markdown-html-orchestrator classifies an input as DOCUMENT, or when invoked directly via /cs:md-document. Reads the design-system config via config_loader.py and inlines the user's 12 derived CSS custom properties; refuses to render if onboarding hasn't run. Single-file output — Google Fonts + Prism.js CDN are the only externals; no framework runtime, no build step. Use after orchestrator routing or after design-system onboarding is confirmed.
Converts a markdown PR writeup or code review (one with ```diff fenced blocks and severity-tagged > [!BLOCKER]/[!MAJOR]/[!MINOR]/[!NIT] callouts) into a single-file 2-column HTML review — unified-diff on the left, severity-tagged annotation cards on the right, top jump-nav listing every finding, mandatory named reviewer footer. Triggers when the markdown-html-orchestrator classifies an input as REVIEW, or when invoked directly via /cs:md-review. Refuses without explicit --reviewer (a code review must name a human), refuses if no diff hunks present (route to md-document instead), and refuses to encode severity in color only (every badge ships color + icon + aria-label per WCAG 1.4.1). Use after orchestrator routing.
Manifests1
{
"name": "markdown-html-skills",
"description": "Convert long markdown files into world-class, single-file, lightly-interactive HTML. v2.10.3 completes the markdown-html/ domain — adds md-slides (slide-deck converter: arrow-key / Space / PgDn / Home/End / P keyboard navigation + presenter mode with split-view clock + notes + next-slide preview + URL-hash deep linking + @media print page-per-slide for PDF export) on top of md-review v2.10.2 (code-review: 2-col diff + severity-tagged margin annotations + WCAG-1.4.1 badges + mandatory named reviewer footer), md-document v2.10.1 (long-form: sticky TOC + scrollspy + search + code-copy + Prism.js autoloader), and the v2.10.0 foundation: markdown-html-orchestrator (context: fork; deterministic doc-type classifier; refuses < 100 lines per Shihipar; refuses without onboarding) + design-system (10-question onboarding wizard; WCAG-AA-validated 12-token palette; project > global > defaults precedence; MARKDOWN_HTML_NO_CONFIG=1 bypass). 15 stdlib-only Python tools (3 per skill across 5 skills), 15 references citing 5-7 sources each, 4 template/schema assets. Inspired by Thariq Shihipar's Claude Code HTML output essay (Medium, 2026). Outputs are single self-contained .html files; only externals are Google Fonts CSS and (opt-in per skill) Prism.js CDN. Domain complete.",
"version": "2.10.3",
"author": {
"name": "Alireza Rezvani",
"url": "https://alirezarezvani.com"
},
"homepage": "https://github.com/alirezarezvani/claude-skills/tree/main/markdown-html",
"repository": "https://github.com/alirezarezvani/claude-skills",
"license": "MIT",
"skills": [
"./skills/markdown-html-orchestrator",
"./skills/design-system",
"./skills/md-document",
"./skills/md-review",
"./skills/md-slides"
],
"source": {
"spec": "Thariq Shihipar — Claude Code HTML output essay (Medium, 2026). Argument: markdown collapses past 100 lines for agent-generated artifacts; HTML restores information density, visual clarity, shareability, and lightweight interaction.",
"build_pattern": "Path B (direct conversion). Orchestrator uses context: fork (research-ops shape). Shared design-system owns onboarding + 12 CSS custom properties read by all converters. Every SKILL.md ships a Forcing-question library section per Matt Pocock grill-with-docs discipline. v2.10.0 shipped the foundation (orchestrator + design-system); v2.10.1 added md-document; v2.10.2 added md-review; v2.10.3 adds md-slides. Domain complete at 5 skills.",
"distinct_from": "Anthropic's official Playground plugin builds interactive prompt-tuning controls (sliders, knobs, prompt-copy-back); this plugin converts existing markdown documents to single-file HTML. Also distinct from marketing/landing/ which generates landing pages from scratch."
}
}