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.