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.

[!WARNING] This converter rejects executable raw HTML such as <script>, event-handler attributes, and javascript: URLs. Sanitize externally supplied Markdown before conversion; do not weaken this boundary to make an untrusted document render.

The source and rendered HTML are both screened. Fenced and indented code, including examples inside blockquotes and lists, remain literal. Local image embedding rejects Windows UNC/network and device paths, including encoded forms, before filesystem access. Remote image URLs remain linked rather than fetched. Default HTML and debug filenames handle .md case-insensitively. Output and debug destinations that alias the source, including hard links, are rejected before conversion or writes.

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 skills/md-to-html/scripts/md-to-html.cjs report.md

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

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

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

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

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

# Debug mode (save preprocessed markdown)
node 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 3 and 1200px width. Diagrams are embedded as base64 PNGs.

Fallback Mode (default): No renderer dependency. The supported simple graph/flowchart subset becomes node and relationship tables. Unsupported types or syntax retain the complete original source in a labeled code block; they are not rendered diagrams or successful table conversions. Use PNG mode when the reader needs a visual diagram.

Print Styling

HTML output includes @media print CSS rules:

• Full-width body with page padding removed
• Text-colored links without underlines
• Code blocks with borders instead of background

Batch Processing

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

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

Troubleshooting

Requirements

• Node.js 24+
• pandoc — run /alex-act-one setup-dependencies to check and install
• mermaid-cli (optional, only for --mermaid-png)

Muscle Script

skills/md-to-html/scripts/md-to-html.cjs

Conversion Acceptance Decision Table

Related Skills

• md-to-word - sister converter for Word output
• Mermaid authoring - use a Mermaid-capable skill; when Core is installed, its markdown-mermaid skill provides diagram guidance
• Markdown linting - validate the source with the project's linter or the lint-clean-markdown skill

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