md-to-html

Convert Markdown documents into self-contained HTML pages with embedded CSS and assets.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/fabioc-aloha/tldr --skill md-to-html-fabioc-aloha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: md-to-html
Source: https://github.com/fabioc-aloha/tldr/tree/main/.github/skills/md-to-html
Command: npx skills add https://github.com/fabioc-aloha/tldr --skill md-to-html-fabioc-aloha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Markdown documents into self-contained HTML pages with embedded CSS, base64-encoded images, and Mermaid diagram rendering, enabling offline viewing and easy sharing.

Core Features & Use Cases

  • Self-contained HTML: embedded CSS, base64-encoded images, and standalone output with no external assets.
  • Mermaid support: render diagrams as PNGs or provide a table fallback for diagrams.
  • TOC and print readiness: optional table of contents and print-ready CSS for easy documentation distribution.
  • Style presets: professional, academic, minimal, dark to fit different documentation needs.
  • Use Case: generate polished documentation pages from Markdown for offline distribution or quick web sharing.

Quick Start

Convert input markdown to a self-contained HTML file with embedded CSS and images.

Frequently Asked Questions about md-to-html

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to a standalone HTML file for offline viewing?▼

To convert Markdown to a standalone HTML file, this Skill embeds CSS, base64-encodes images, and renders Mermaid diagrams directly into the output. This creates self-contained HTML pages requiring no external assets for offline viewing and sharing.

Can I render Mermaid diagrams when converting Markdown to HTML?▼

Yes, you can render Mermaid diagrams when converting Markdown to HTML. The Skill supports rendering diagrams as embedded PNGs or provides a table fallback to ensure visual content displays correctly in the final document.

Do I need Node.js to convert Markdown files into self-contained HTML pages?▼

Yes, you need Node.js 18 or higher to convert Markdown files into self-contained HTML pages. Full functionality, including Mermaid diagram rendering, may also rely on external tools such as pandoc and mermaid-cli.

What is the best way to generate print-ready documentation from Markdown?▼

The best way to generate print-ready documentation from Markdown is using a converter with embedded CSS and an optional table of contents. This Skill provides professional, academic, minimal, and dark style presets for polished, distribution-ready output.

Why do external images break in my converted Markdown to HTML output?▼

External images break in Markdown to HTML output when they rely on outside links. This Skill solves that by base64-encoding images directly into the HTML, ensuring your self-contained documents display correctly without external dependencies.