How do I install the Md2html skill?

Run npx skillmds@latest add liorhai5/md2html in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Md2html safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Md2html?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Md2html free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Md2html?

liorhai5 (@liorhai5) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Md2html by liorhai5 — Agent Skill

Name: Md2html
Author: liorhai5

Md2html

Convert a local markdown file to a self-contained HTML file and open it in the browser, so it can be copy-pasted into Google Docs with formatting and images intact. Use when the user asks to "turn this markdown into a Google Doc", "paste this md into Docs", or "convert md to html for pasting".

liorhai5 b47b435 2 files · 20.0 KB Updated Sep 17, 2026

File contents

md2html

Convert the markdown file given in $ARGUMENTS to HTML and open it in the browser. The user then selects-all (⌘A), copies (⌘C), and pastes (⌘V) into Google Docs.

Run

The skill is a single dependency-free script (Node ≥ 18, no install step, nothing bundled). Determine this SKILL.md's own directory as {baseDir}, then run:

node "{baseDir}/md2html.mjs" "$ARGUMENTS"

Flags: --no-open (convert only), --no-render (skip diagram/SVG rendering), --mermaid-cmd "<cmd {in} {out}>" (custom mermaid renderer, argv with placeholders).

How it works — env tools, never bundled libraries

Every capability is served by whatever tool exists on the user's machine (first match wins); when a tool is missing, md2html says exactly what to install:

Capability	Tools tried in order	If none found
markdown → HTML (required)	`pandoc` · `markdown-it` (npx cache) · `python3` markdown module	no output, exit ≠ 0, install suggestions printed
mermaid fence → PNG (optional)	`--mermaid-cmd` · `mmdc` · npx-cached `mmdc`	fence stays a code block + hint
local `.svg` → PNG (optional)	`rsvg-convert` · `inkscape` · `cairosvg` · `magick`/`convert`	SVG inlined as-is (Docs may not show it) + hint

Local images (and rendered diagrams) are inlined as base64 PNG — they survive the Docs paste.
Remote images (https://…) pass through unchanged. No network calls; content never leaves the machine.
PlantUML/graphviz fences stay code blocks.
macOS only for the auto-open step (open); elsewhere, open the printed .html path manually.

Agent duties

Read stderr after every run. Degradation flags and install hints land there (exit code stays 0 when HTML was produced). Surface them to the user and offer the install as a question — never install anything silently.
If the markdown engine itself is missing (exit ≠ 0), relay the printed candidates; pandoc is the recommended one (full GFM: tables, task lists, footnotes).
Engine fidelity varies: if the document uses task lists or footnotes and pandoc is absent, tell the user the output may lose those constructs and recommend brew install pandoc.
For UI mockups, author an .svg next to the markdown and reference it as an image (![](./mockup.svg)) — md2html rasterizes and inlines it in one pass. Keep the .svg source for later edits. Flow/architecture diagrams go in ```mermaid fences, rendered the same way (headless Chrome via mmdc — expect a few seconds per diagram).

---name: md2htmldescription: Convert a local markdown file to a self-contained HTML file and open it in the browser, so it can be copy-pasted into Google Docs with formatting and images intact. Use when the user asks to "turn this markdown into a Google Doc", "paste this md into Docs", or "convert md to html for pasting".---# md2htmlConvert the markdown file given in `$ARGUMENTS` to HTML and open it in the browser.The user then selects-all (⌘A), copies (⌘C), and pastes (⌘V) into Google Docs.## RunThe skill is a single dependency-free script (Node ≥ 18, no install step, nothing bundled).Determine this SKILL.md's own directory as `{baseDir}`, then run:```bashnode "{baseDir}/md2html.mjs" "$ARGUMENTS"```Flags: `--no-open` (convert only), `--no-render` (skip diagram/SVG rendering),`--mermaid-cmd "<cmd {in} {out}>"` (custom mermaid renderer, argv with placeholders).## How it works — env tools, never bundled librariesEvery capability is served by whatever tool exists on the user's machine (firstmatch wins); when a tool is missing, md2html says exactly what to install:| Capability | Tools tried in order | If none found ||---|---|---|| markdown → HTML (**required**) | `pandoc` · `markdown-it` (npx cache) · `python3` markdown module | no output, exit ≠ 0, install suggestions printed || mermaid fence → PNG (optional) | `--mermaid-cmd` · `mmdc` · npx-cached `mmdc` | fence stays a code block + hint || local `.svg` → PNG (optional) | `rsvg-convert` · `inkscape` · `cairosvg` · `magick`/`convert` | SVG inlined as-is (Docs may not show it) + hint |- Local images (and rendered diagrams) are inlined as base64 PNG — they survive the Docs paste.- Remote images (`https://…`) pass through unchanged. No network calls; content never leaves the machine.- PlantUML/graphviz fences stay code blocks.- macOS only for the auto-open step (`open`); elsewhere, open the printed `.html` path manually.## Agent duties1. **Read stderr after every run.** Degradation flags and install hints land there (exit code stays 0 when HTML was produced). Surface them to the user and offer the install as a question — **never install anything silently**.2. If the markdown engine itself is missing (exit ≠ 0), relay the printed candidates; `pandoc` is the recommended one (full GFM: tables, task lists, footnotes).3. **Engine fidelity varies**: if the document uses task lists or footnotes and `pandoc` is absent, tell the user the output may lose those constructs and recommend `brew install pandoc`.4. For UI mockups, author an `.svg` next to the markdown and reference it as an image (`![](./mockup.svg)`) — md2html rasterizes and inlines it in one pass. Keep the `.svg` source for later edits. Flow/architecture diagrams go in ```` ```mermaid ```` fences, rendered the same way (headless Chrome via `mmdc` — expect a few seconds per diagram).

Frequently asked questions