haidang1810

haidang1810 / md2html

Public

Your AI writes docs — md2html turns them into pages people actually read. A portable skill for Claude Code / Codex / Antigravity that converts long-form Markdown (plans, specs, system designs, RFCs, runbooks, postmortems, brainstorms) into self-contained HTML with Mermaid, timelines, callouts, TOC. Multi-language.

16
2
100% credibility
Found May 14, 2026 at 25 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
HTML
AI Summary

md2html enables AI assistants to convert lengthy Markdown documents like plans, specs, and notes into polished, self-contained HTML webpages featuring a sidebar table of contents, diagrams, themes, and interactive elements.

How It Works

1
👀 Discover md2html

You hear about md2html from a friend or online, a handy way to turn your AI's long notes into beautiful webpages everyone wants to read.

2
🛠️ Add to your AI helper

You easily add the simple instructions to your favorite AI assistant so it can use this new skill right away.

3
📝 Pick your document

You grab a long Markdown file your AI created, like a plan or design full of great ideas but hard to read.

4
✨ Tell AI to transform it

You simply say to your AI helper 'make this into a nice webpage' and it works its magic in seconds.

5
📄 Open the new page

A polished HTML file appears next to your original, ready to open in any web browser with a sidebar menu and pretty diagrams.

6
🌙 Switch themes and explore

You flip between light and dark modes, scroll smoothly, and see timelines and comparisons that make everything crystal clear.

🎉 Share and celebrate

You email the file or drop it in chat, and your team finally reads and loves the doc instead of ignoring it.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 25 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is md2html?

md2html converts long-form Markdown docs—like plans, specs, system designs, RFCs, runbooks, postmortems, and brainstorms—into self-contained HTML pages that actually get read. Feed it a file via AI agents like Claude Code, Codex, or Antigravity with a simple `/md2html plan.md` command, and it outputs polished HTML next to the source, complete with sidebar TOC, Mermaid diagrams, timelines, callouts, and light/dark themes. No servers or builds needed; it's a zero-install skill that analyzes content to add diagrams and layouts automatically.

Why is it gaining traction?

Unlike basic md2html tools or vditor md2html converters, this one acts as an analyzer: it spots flows for Mermaid flowcharts, trade-offs for comparison cards, and steps for timelines, turning walls of text into product-like pages. Portable across agents without Node or Python deps, it supports multi-language output matching your source (English, Vietnamese, Chinese, and more), plus production UX like scroll-spy, mobile drawers, and print styles. Devs hook it into their AI workflow for instant, shareable docs that feel designed.

Who should use this?

AI-heavy engineers using Claude Code, Codex, or Antigravity to generate docs will save hours on formatting system designs or brainstorms. SREs crafting runbooks and postmortems get timelines and callouts without manual tweaks; product managers turning AI-drafted plans into stakeholder-ready HTML. It's for anyone tired of monospace MD dumps in Slack or email.

Verdict

Try it if you're in the AI agent ecosystem—solid docs and examples make setup dead simple, despite the 1.0% credibility score from just 16 stars signaling early maturity. Low risk for a git clone, but watch for roadmap items like offline Mermaid before production docs.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.