Convertidor online gratuito de MERMAID a PDF

PDF se utiliza cuando un diagrama de Mermaid debe compartirse con personas que no tienen un editor de Mermaid, imprimirse o conservarse en un diseño fijo. Convertir el diagrama de origen a PDF representa su diagrama de flujo o mapa mental como un documento portátil en lugar de dejarlo como código de diagrama editable.

Qué es el formato MERMAID

Mermaid es un formato de diagramas basado en texto que se utiliza para diagramas de flujo, mapas mentales, diagramas de secuencia, diagramas entidad-relación, líneas de tiempo y documentación visual relacionada. Los archivos suelen utilizar .mmd o .mermaid; el código de Mermaid también puede aparecer dentro de bloques delimitados en archivos Markdown.

Un archivo de Mermaid contiene instrucciones de origen, como etiquetas de nodos, conexiones, declaraciones de diseño y estilos, en lugar de una imagen terminada. Mermaid Live Editor, Mermaid CLI, las extensiones de Visual Studio Code, Obsidian y los sistemas de documentación Markdown pueden crear o representar estos diagramas.

Qué es el formato PDF

PDF almacena el diagrama representado junto con las dimensiones de página, las fuentes, los colores y la información de diseño. Es adecuado para impresión, archivos adjuntos de correo electrónico, documentación, informes técnicos y copias de archivo, porque los destinatarios pueden verlo con software PDF estándar sin instalar Mermaid.

PDF normalmente es un formato de presentación, no un formato de origen: para editar el diagrama, normalmente es necesario modificar el archivo de Mermaid original y exportar un PDF nuevo.

Cómo convertir MERMAID a PDF

Uso de Mermaid CLI

1. Instala Node.js si aún no está instalado.
2. Instala Mermaid CLI con npm install -g @mermaid-js/mermaid-cli.
3. Coloca el código fuente del diagrama en un archivo como flowchart.mmd. Asegúrate de que comience con una sintaxis de Mermaid válida, por ejemplo flowchart TD.
4. Ejecuta mmdc -i flowchart.mmd -o flowchart.pdf.
5. Abre flowchart.pdf y comprueba las etiquetas, los conectores, los saltos de página y la representación de las fuentes.

Para que un diagrama quepa en una sola página PDF, utiliza mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. El comando utiliza el renderizador de Mermaid basado en Chromium, por lo que el PDF contiene el diagrama representado en lugar del código fuente original.

Uso de 101convert.com

Puedes convertir el archivo en 101convert.com de forma gratuita sin instalar software. Sube el archivo de Mermaid, selecciona PDF como formato de salida, inicia la conversión y descarga el documento resultante. Esta opción es útil cuando Node.js y Mermaid CLI no están disponibles.

Uso de un editor de Mermaid

Abre el código fuente en un editor compatible con la representación de Mermaid y, a continuación, utiliza Export → PDF o la opción del navegador Print → Save as PDF. La impresión desde el navegador es una alternativa; puede incluir márgenes de página, encabezados, pies de página o escalado que no están presentes en una exportación directa de Mermaid CLI.

Consideraciones sobre calidad y compatibilidad

Los diagramas grandes pueden reducirse hasta que las etiquetas sean difíciles de leer. Divide un código fuente saturado en varios diagramas, aumenta las dimensiones de la página mediante la configuración de Mermaid CLI o exporta archivos PDF independientes para las distintas secciones.

El resultado PDF depende de la versión de Mermaid, el tema de representación, las fuentes instaladas y los iconos o recursos externos referenciados. Utiliza la misma versión de Mermaid CLI para obtener exportaciones reproducibles y elige una fuente común o incrusta las fuentes necesarias mediante la configuración del renderizador cuando el PDF vaya a abrirse en otros sistemas.

Las funciones interactivas, la posibilidad de editar el código fuente y algunos estilos específicos del navegador no se conservan en PDF. Conserva el archivo .mmd original junto al PDF cuando sea probable que se realicen cambios en el futuro.