md2html

Convert long-form Markdown documents into self-contained HTML pages with diagrams and styled components.

7|Updated May 13, 2026
One-click install
npx skills add https://github.com/DawnMoon1542/agents-skills --skill md2html-dawnmoon1542
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md2html
Source: https://github.com/DawnMoon1542/agents-skills/tree/main/md2html
Command: npx skills add https://github.com/DawnMoon1542/agents-skills --skill md2html-dawnmoon1542

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long Markdown documents produced by AI agents (plans, specs, system designs, postmortems) are hard to read as raw text walls, and nobody on the team wants to open a plain .md file. This Skill analyzes the document structure and renders it as a single self-contained HTML page that reads like a designed docs page. ## Core Features & Use Cases - Semantic component mapping: The agent decides which sections become Mermaid diagrams, step timelines, pros-cons tables, comparison cards, callouts, or collapsible panels instead of doing a literal Markdown-to-HTML conversion. - Self-contained output: One HTML file with embedded CSS, light/dark Claude-orange theme, sidebar TOC with scroll-spy, copy-to-clipboard code blocks, and KaTeX formula rendering via CDN. - Multi-language UI: Interface labels follow the source document language, with built-in label tables for English, Vietnamese, Chinese, Japanese, Korean, Spanish, French, and German. - Use Case: After your AI writes a 2,000-word migration plan, run the skill on plan.md to get plan.html with a Mermaid architecture diagram, a five-step timeline, risk callouts, and a comparison of message-bus options — ready to email or drop in Slack. ## Quick Start Ask your agent to run /md2html on a Markdown file such as plan.md, and it will write a styled plan.html next to the source and open it in your browser.

Frequently Asked Questions about md2html

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Markdown file to a styled HTML page?

Invoke the skill with /md2html followed by your file path, for example /md2html plan.md. The agent reads the source, picks components from its catalog, and writes plan.html next to the source file, then opens it in your browser.

What is the difference between md2html and a standard Markdown-to-HTML converter?

A standard converter translates Markdown syntax literally, while this skill analyzes the document and chooses presentation components: flows become Mermaid diagrams, numbered actions become step timelines, trade-offs become pros-cons tables, and options become comparison cards.

Does md2html require npm install or a build step?

No installation is required. The skill is a prompt, an HTML template, a component catalog, and examples. Mermaid, Highlight.js, and KaTeX load from CDN at page-open time, so no Node, Python, or Docker is needed.

Can I use md2html with Codex CLI or agents other than Claude Code?

Yes. For Codex CLI, symlink SKILL.md into the prompts directory; for Antigravity or other agents, paste SKILL.md into custom instructions and grant file read/write access to the skill folder. The skill contains no agent-specific code.

Does md2html support non-English documents?

Yes. The agent detects the source language and localizes all UI labels, with built-in tables for English, Vietnamese, Chinese, Japanese, Korean, Spanish, French, and German. Other languages are translated equivalently, and the html lang attribute is set accordingly.

What are the limitations of the generated HTML output?

Runtime rendering of Mermaid, Highlight.js, and KaTeX depends on CDN assets, so diagrams and math need internet access when the file is opened. RTL languages like Arabic render LTR with the sidebar on the left, which is a known limitation.