| name | md-to-html |
| description | Convertí Markdown a HTML autocontenido con estilo Pandi cuando pidan un mirror, un informe `.html` único o la estética HTML de un proyecto. |
md-to-html
Convierte un documento Markdown en una página HTML autocontenida y estilada: un solo archivo, sin paso de compilación,
con variantes clara y oscura incluidas.
En 30 segundos
Dentro de Pi, preferí /docs o el tool markdown_to_html; fuera de Pi, corré el CLI del convertidor.
node <converter>/markdown-to-html.mjs <path/to/doc.md> --kicker "Proyecto · Área"
El archivo de salida queda junto al origen, salvo que pases -o.
Dónde correrlo
- Dentro de una sesión de pi: usá el comando
/docs o el tool markdown_to_html de la extensión pandi-docs.
Ambos usan el mismo convertidor, con resolución de paths y feedback por encima. Preferilos si están disponibles.
- En cualquier otro lado (
Claude Code, CI, shell común): corré el CLI. El convertidor viene con el paquete
instalado (node_modules/@pandi-coding-agent/pandi-docs/scripts/markdown-to-html.mjs) o con un checkout de
pandi-extensions (extensions/pandi-docs/scripts/markdown-to-html.mjs).
Pasos
-
Generar el HTML.
node <converter>/markdown-to-html.mjs <path/to/doc.md> --kicker "Proyecto · Área"
Elegí el --kicker según el área del doc (Policy, Research, Informe, Docs); el valor por defecto es
Pandi artifact.
Cierre: el comando termina con exit 0 y existe el .html junto al origen o en la ruta indicada por -o.
-
Ajustar el estilo si hace falta.
--tokens palette.css — cambia solo la paleta de colores (custom properties) y conserva el layout Pandi.--css style.css — reemplaza toda la hoja de estilos por la propia del proyecto; tiene prioridad sobre --tokens.
Cierre: si aplicaste una opción, el comando ejecutado la incluye y la inspección de la salida confirma la paleta
o stylesheet esperados.
-
Revisar el resultado. Abrí o leé la salida y verificá: título del masthead tomado del primer # h1, kicker, TOC
(aparece con 4 o más secciones ##), callouts etiquetados desde marcadores tipo [!NOTE], bloques de código con
resaltado y diagramas mermaid.
Cierre: verificaste cada elemento aplicable; dejá explícito el motivo de cualquier elemento que no aplique al
documento.
-
Si el mirror debe quedar permanente, agregá el doc a mirrors.json y derivá a /sync-doc-mirrors. Ese flujo se
ocupa de check/sync, los recordatorios de redeploy y la poda de huérfanos.
Cierre: el par quedó declarado en el manifest y el handoff al flujo de mirrors está explícito.
Notas
- El Markdown es la fuente de verdad: nunca edites a mano el
.html generado.
- El contrato completo de apariencia visual (tokens, layout, callouts y tematización de mermaid) vive en el skill
pandi-artifact-style.
