Md To Html

Write in Markdown, share as a polished web page — zero dependencies for viewers

Convert Markdown documents into self-contained HTML files with embedded CSS, base64 images, and Mermaid diagram rendering. Ready for quick-share distribution, offline viewing, print, or email attachment.

When to Use

• Sharing formatted documents without requiring Word or PDF viewers
• Creating self-contained HTML pages for offline distribution
• Generating printable web pages from Markdown sources
• Quick previews of documentation with professional styling
• Email attachments that open in any browser
• Static site generation from Markdown sources

Supported Formatting

Key Features

Usage

# Basic conversion (professional style)
node .github/skills/md-to-html/scripts/md-to-html.cjs report.md

# Academic style with TOC
node .github/skills/md-to-html/scripts/md-to-html.cjs thesis.md --style academic --toc

# Dark mode output
node .github/skills/md-to-html/scripts/md-to-html.cjs docs.md --style dark

# Mermaid diagrams rendered as PNG (high quality)
node .github/skills/md-to-html/scripts/md-to-html.cjs architecture.md --mermaid-png

# Custom output path
node .github/skills/md-to-html/scripts/md-to-html.cjs README.md output/readme.html

# Dry run (validate without generating)
node .github/skills/md-to-html/scripts/md-to-html.cjs report.md --dry-run

# Debug mode (save preprocessed markdown)
node .github/skills/md-to-html/scripts/md-to-html.cjs report.md --debug

Options Reference

Style Presets

Mermaid Diagram Support

PNG Mode (--mermaid-png): Requires mermaid-cli (mmdc). Renders at scale 8, 2400px width for crisp output. Diagrams are embedded as base64 PNGs.

Fallback Mode (default): No external dependencies. Converts diagram syntax to an ASCII table representation suitable for text-only viewing.

Print Styling

HTML output includes @media print CSS rules:

• Page breaks before H1 headings
• No background colors (ink-friendly)
• Link URLs shown after text
• Code blocks with borders instead of background
• Proper margins for binding

Batch Processing

# Convert all markdown files in a directory
for file in docs/*.md; do
  node .github/skills/md-to-html/scripts/md-to-html.cjs "$file" --style professional
done

# PowerShell equivalent
Get-ChildItem docs/*.md | ForEach-Object {
  node .github/skills/md-to-html/scripts/md-to-html.cjs $_.FullName --style professional
}

Troubleshooting

Requirements

• Node.js 24+
• pandoc (winget install pandoc)
• mermaid-cli (optional, only for --mermaid-png)

Muscle Script

.github/skills/md-to-html/scripts/md-to-html.cjs (v1.0.0)

Conversion Acceptance Decision Table

Related Skills

• md-to-word — Sister converter for Word document output
• md-scaffold — Generate converter-ready Markdown templates
• markdown-mermaid — Diagram authoring for embedded Mermaid
• lint-clean-markdown — Pre-validate markdown before conversion
• nav-inject — Add navigation tables for multi-file suites

Skill version: 2.0.0 | Last updated: 2026-04-14 | Category: document-conversion

Falsifiability

• This skill is wrong if generated HTML fails W3C validation on structural elements the skill explicitly handles
• The conversion flags are stale if Pandoc changes default HTML5 output behavior in a major version
• Not earning tokens if the output loses semantic structure (headings, lists, code blocks) that raw Pandoc preserves without the documented options