md-to-html

Convert Markdown to standalone HTML pages with embedded CSS, images, and Mermaid diagrams

Repository: fabioc-aloha/tldr
Letzte Quellaktivität: 3. Mai 2026 um 18:19
Erkannte Sprache von SKILL.md: Englisch
Sterne: 0
Forks: 0

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/fabioc-aloha/tldr --skill md-to-html

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

Markdown to HTML Conversion

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

Format

Status

Notes

Headings

✅

H1-H6 with styled colors

Bold/Italic

✅

Standard emphasis

Links

✅

Styled with underline on hover

Images

✅

Base64 embedded or linked

Code blocks

✅

Syntax highlighting, monospace font

Inline code

✅

Background highlight

Tables

✅

Striped rows, header styling

Blockquotes

✅

Left border, italic style

Lists

✅

Ordered, unordered, nested

Task lists

✅

Checkbox rendering

Mermaid diagrams

✅

PNG or table fallback

SVG

✅

Inline or base64 embedded

Horizontal rules

✅

Styled dividers

Footnotes

✅

Via pandoc

Math (KaTeX)

type	skill
lifecycle	stable
name	md-to-html
description	Convert Markdown to standalone HTML pages with embedded CSS, images, and Mermaid diagrams
tier	standard
inheritance	inheritable
applyTo	*/md-to-html,/converthtml
muscle	.github/muscles/md-to-html.cjs
currency	2026-04-30T00:00:00.000Z
lastReviewed	2026-04-30T00:00:00.000Z

Markdown to HTML Conversion

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

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

Format	Status	Notes
Headings	✅	H1-H6 with styled colors
Bold/Italic	✅	Standard emphasis
Links	✅	Styled with underline on hover
Images	✅	Base64 embedded or linked
Code blocks	✅	Syntax highlighting, monospace font
Inline code	✅	Background highlight
Tables	✅	Striped rows, header styling
Blockquotes	✅	Left border, italic style
Lists	✅	Ordered, unordered, nested
Task lists	✅	Checkbox rendering
Mermaid diagrams	✅	PNG or table fallback
SVG	✅	Inline or base64 embedded
Horizontal rules	✅	Styled dividers
Footnotes	✅	Via pandoc
Math (KaTeX)

Feature	Details
Style presets	professional, academic, minimal, dark
Self-contained	All CSS embedded in `<style>` block, no external deps
Image embedding	Local images converted to base64 data URIs
Mermaid support	PNG rendering or table fallback for diagrams
Print-ready	CSS `@media print` rules included
TOC generation	Optional table of contents via `--toc`
Frontmatter	Extracted for title, stripped from output

Option	Default	Description
`--style PRESET`	professional	Style preset: professional, academic, minimal, dark
`--toc`	off	Generate table of contents from headings
`--embed-images`	true	Convert local images to base64 data URIs
`--no-embed-images`	-	Keep image paths as-is (external references)
`--strip-frontmatter`	true	Remove YAML frontmatter from output
`--mermaid-png`	off	Render Mermaid as PNG (requires mmdc)
`--mermaid-fallback`	default	Convert Mermaid to table representation
`--debug`	off	Save preprocessed markdown as _debug_combined.md
`--dry-run`	off	Validate only, no HTML output

Preset	Font	Max Width	Colors	Best For
professional	Segoe UI	900px	Blue headings, white bg	Business docs, reports
academic	Palatino Linotype	750px	Dark headings, cream bg	Papers, theses
minimal	Inter	800px	Black/gray, white bg	Clean, modern pages
dark	Segoe UI	900px	Light text, dark bg	Dark mode preference

Diagram Type	PNG Mode	Fallback Mode
Flowchart	✅ Full render	✅ Table
Sequence	✅ Full render	✅ Table
Class	✅ Full render	✅ Table
State	✅ Full render	✅ Table
ER	✅ Full render	✅ Table
Gantt	✅ Full render	⚠️ Limited
Pie	✅ Full render	✅ Table
Journey	✅ Full render	⚠️ Limited

Problem	Cause	Solution
"pandoc not found"	pandoc not installed	`winget install pandoc`
Mermaid not rendering	mmdc not installed	`npm install -g @mermaid-js/mermaid-cli` or use fallback
Images missing	Relative paths broken	Use `--embed-images` (default)
Output too wide on print	Style preset issue	Use academic style for print
Special characters garbled	Encoding issue	Ensure source is UTF-8

md-to-html

Installationsoptionen

Quelldateien prüfen

Markdown to HTML Conversion

When to Use

Supported Formatting

Markdown to HTML Conversion

When to Use

Supported Formatting

Key Features

Usage

Options Reference

Style Presets

Mermaid Diagram Support

Print Styling

Batch Processing

Troubleshooting

Requirements

Muscle Script

Conversion Acceptance Decision Table

Related Skills

Condition	Verdict	Action
All headings, lists, tables, code blocks render correctly	Accept	Ship as-is
Mermaid diagrams rendered as PNG/SVG with correct layout	Accept	Verify diagram labels readable
Mermaid diagrams missing or show raw syntax	Reject	Check mermaid-cli installed; re-run with `--mermaid-png`
Math equations (KaTeX/MathJax) render correctly	Accept	Spot-check complex equations
Math equations show raw LaTeX source	Reject	Verify KaTeX CSS/JS included in template
Embedded images display at correct size	Accept	Confirm no broken `<img>` tags
Images missing or show broken placeholders	Reject	Check paths are relative and files exist
CSS custom properties resolve (colors, fonts)	Accept	Visual spot-check against brand
Inline styles lost or overridden by browser defaults	Warning	Add `!important` or inline fallbacks
Output file size >5MB for a simple document	Warning	Check for unoptimized base64 images
HTML validates (no unclosed tags, no script injection)	Accept	Required for security
HTML contains `<script>` from untrusted source	Reject	Sanitize; only allow known libraries

md-to-html

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

Markdown to HTML Conversion

When to Use

Supported Formatting

Mehr aus diesem Repository

Markdown to HTML Conversion

When to Use

Supported Formatting

Key Features

Usage

Options Reference

Style Presets

Mermaid Diagram Support

Print Styling

Batch Processing

Troubleshooting

Requirements

Muscle Script

Conversion Acceptance Decision Table

Related Skills