md-to-html

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

Repositorio: fabioc-aloha/alex-cognitive-architecture
Última actividad en el origen: 26 de abril de 2026 a las 18:45
Idioma detectado de SKILL.md: inglés
Estrellas: 0
Forks: 1

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

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-22T00:00:00.000Z

Markdown to HTML Conversion

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

Staleness Watch: See EXTERNAL-API-REGISTRY.md for source URLs and recheck cadence

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

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

Opciones de instalación

Revisa los archivos de origen

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

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

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

Más de este repositorio