Leaderboard/Docs/md2html
Last commit on May 14, 2026·Created on May 14, 2026

haidang1810/md2html

Turns verbose Markdown into a document a tired engineer can scan.
Combined rank
#552
across all skills
In Docs
#2
category rank
Stars
422
+0.2% in last 7d
Forks
27
0.0% in last 7d
Watchers
1
0.0% in last 7d
Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
TL;DR

This skill converts long-form Markdown — plans, specs, RFCs, runbooks, postmortems, system designs, brainstorm notes — into a single, self-contained HTML page. It adds Mermaid diagrams for any flow three hops or more, step timelines, callouts for warnings and decisions, a sidebar table of contents, and a light/dark Claude-orange theme. The output adapts to the source document's language, translating UI labels while keeping code and commands verbatim. It helps technical writers, architects, and SREs turn written prose into browsable, scannable documents without leaving the agent workflow.

WHO IT'S FOR
AI Agent Power Users
convert long-form markdown to shareable HTML pages
Technical Documentation Engineers
convert specs, RFCs, and runbooks to HTML
Software Architects and Technical Leads
present system design and architecture plans as HTML
Site Reliability Engineers and DevOps Engineers
generate postmortems and runbooks with timelines and callouts
Repository contents

1 skill file

Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.
Compatibility not documented

Use this skill

Follow the documented setup, then try a first task.

I’m using

Claude Code

Installs: Complete md2html skill bundle, including SKILL.md, template.html, components.md, examples, and supporting repository files. · Claude Code

Before you start
  • Claude Code
  • Git
  1. In a terminal, clone the md2html repository into Claude Code's skills directory.

    git clone https://github.com/haidang1810/md2html ~/.claude/skills/md2html
  2. Reload the Claude Code session. Then, in the agent session, invoke md2html on a Markdown document; replace plan.md with the path to the source Markdown file.

    /md2html plan.md
README.md · Checked Sep 18, 2026

Give it something to do.

Author’s example

Turn a Markdown plan into a scannable HTML page

Uses md2html

  • Replace plan.md with the path to the source Markdown document. The example path is a placeholder; by default, the HTML output is written next to the source.
/md2html plan.md
SKILL.md · Checked Sep 18, 2026README.md · Checked Sep 18, 2026