BeClaude

md-to-html

New
GitHub TrendingDocumentationby vochinguyen

Converts Markdown files to standalone HTML with Mermaid diagram support. Use when the user wants to convert a .md file to HTML, says "md to html", "markdown to html", "convert markdown", "mermaid html", or provides a .md file path for HTML export.

First seen 6/17/2026
View Source

Summary

This skill converts Markdown files into standalone HTML pages with built-in support for Mermaid diagrams, tables, and code blocks.

  • It automatically fetches the Mermaid rendering library and applies GitHub-like styling, making it ideal for sharing technical documentation or notes as polished web pages.

Overview

MD to HTML Converter

Converts a Markdown file to a styled, self-contained HTML file. Supports Mermaid diagrams, tables, fenced code blocks, and all standard Markdown.

Quick start

bash
node ~/.cursor/skills/md-to-html/scripts/convert.js /path/to/file.md

Output: /path/to/file.html and mermaid.min.js in the same directory.

What the script does

  1. Reads the .md file
  2. Installs marked on first run (via npm install --prefix)
  3. Converts Markdown → HTML using marked
  4. Transforms <pre><code class="language-mermaid"> blocks → <div class="mermaid"> so Mermaid renders them
  5. Downloads mermaid.min.js from https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js (only if not already present)
  6. Writes a full HTML page with GitHub-like CSS + Mermaid support

When user provides a file

Run the script directly — no extra setup needed. Node.js is required (pre-installed on macOS).

bash
node ~/.cursor/skills/md-to-html/scripts/convert.js "$MD_FILE_PATH"

Then open the resulting .html file in a browser.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file

Add the configuration to .claude/skills/md-to-html.md

3
Invoke in Claude Code
/md-to-html

Use Cases

Convert a README.md into a self-contained HTML file for sharing with non-technical stakeholders.
Generate a styled HTML report from a Markdown document containing Mermaid flowcharts and sequence diagrams.
Quickly preview a Markdown file as a web page without needing a separate Markdown viewer or server.
Create a portable HTML version of project documentation that can be opened offline in any browser.
Transform meeting notes or technical specs written in Markdown into a clean, readable HTML format.
Produce a single-file HTML output that includes embedded diagrams for use in presentations or wikis.

Usage Examples

1

/md-to-html convert my-documentation.md

2

Convert the file README.md to HTML with Mermaid support

3

Run md-to-html on /path/to/notes.md and open the result

View source on GitHub

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is md-to-html?

This skill converts Markdown files into standalone HTML pages with built-in support for Mermaid diagrams, tables, and code blocks. It automatically fetches the Mermaid rendering library and applies GitHub-like styling, making it ideal for sharing technical documentation or notes as polished web pages.

How to install md-to-html?

To install md-to-html: create the skills directory (mkdir -p .claude/skills), then add the config to .claude/skills/md-to-html.md. Finally, /md-to-html in Claude Code.

What is md-to-html best for?

md-to-html is a other categorized under Documentation. Created by vochinguyen.

What can I use md-to-html for?

md-to-html is useful for: Convert a README.md into a self-contained HTML file for sharing with non-technical stakeholders.; Generate a styled HTML report from a Markdown document containing Mermaid flowcharts and sequence diagrams.; Quickly preview a Markdown file as a web page without needing a separate Markdown viewer or server.; Create a portable HTML version of project documentation that can be opened offline in any browser.; Transform meeting notes or technical specs written in Markdown into a clean, readable HTML format.; Produce a single-file HTML output that includes embedded diagrams for use in presentations or wikis..