Convertidor online gratuito de MERMAID a PNG

PNG es útil cuando es necesario insertar un diagrama de Mermaid en un documento, una presentación, un sistema de seguimiento de incidencias o un archivo basado en imágenes que no puede renderizar el código fuente de Mermaid. La conversión también crea una instantánea visual fija para compartir, mientras que el archivo Mermaid original permanece editable.

Qué es el formato MERMAID

Un archivo MERMAID es una definición de diagrama de texto sin formato, que normalmente se guarda con la extensión .mermaid o .mmd. Contiene sintaxis de Mermaid para diagramas de flujo, mapas mentales, diagramas de secuencia, diagramas de clases, diagramas de estados, diagramas entidad-relación y otros gráficos estructurados, en lugar de píxeles almacenados.

Los archivos Mermaid se crean o editan en Mermaid Live Editor, Mermaid CLI, Visual Studio Code con extensiones de Mermaid y aplicaciones como Obsidian, GitLab y GitHub que admiten el renderizado de Mermaid. Puede encontrar uno cuando un diagrama está almacenado en un repositorio de código fuente, un documento Markdown, una aplicación de notas o un proyecto de documentación.

Qué es el formato PNG

PNG es un formato de imagen rasterizada compatible con navegadores web, software de oficina, herramientas de presentación, visores de imágenes y la mayoría de los sistemas de documentos. Utiliza compresión sin pérdida, conserva mejor que JPEG las líneas nítidas de colores sólidos y el texto, y puede almacenar fondos transparentes.

PNG es adecuado cuando el destinatario necesita una imagen común en lugar de sintaxis de Mermaid. No es ideal para editar elementos individuales del diagrama ni para diagramas extremadamente grandes, porque ampliar una imagen rasterizada puede hacer que el texto y las líneas se vean pixelados.

Cómo convertir MERMAID a PNG

Uso de 101convert en línea

1. Abra el conversor de MERMAID a PNG en 101convert.com.
2. Cargue el archivo .mermaid o .mmd.
3. Inicie la conversión y descargue el archivo .png generado.

Esta opción no requiere software instalado y es adecuada cuando el archivo Mermaid no contiene información confidencial.

Uso de Mermaid CLI

Para realizar conversiones locales repetibles, instale Mermaid CLI con Node.js:

npm install -g @mermaid-js/mermaid-cli

Renderice un archivo de código fuente con:

mmdc -i diagram.mermaid -o diagram.png

La entrada también puede utilizar la extensión .mmd. Para aumentar la resolución rasterizada, aplique un factor de escala:

mmdc -i diagram.mmd -o diagram.png -s 2

Utilice un color de fondo cuando la transparencia no sea adecuada:

mmdc -i diagram.mmd -o diagram.png -b white

Mermaid CLI renderiza el código fuente con un navegador sin interfaz gráfica. Si la instalación informa de un problema con Chromium o con el navegador, siga las instrucciones de configuración del navegador correspondientes a la versión de Mermaid CLI antes de volver a ejecutar el comando.

Uso de un editor de diagramas

Abra el código fuente en Mermaid Live Editor u otro editor compatible con Mermaid, compruebe que la vista previa se renderice correctamente y, a continuación, elija Export → PNG o el comando equivalente de exportación de imágenes. La configuración de exportación puede permitir un fondo transparente, la selección de un tema o el ajuste de la escala.

Consideraciones sobre calidad y compatibilidad

El PNG refleja el renderizador de Mermaid, la versión de Mermaid, el tema, las fuentes disponibles y cualquier configuración de inicialización utilizada durante la exportación. Por lo tanto, un diagrama puede verse diferente cuando lo renderiza otra aplicación o versión.

Aumente la escala de exportación para los diagramas que contengan etiquetas pequeñas; cambiar el ancho del PNG después de la exportación no recupera los detalles perdidos. Conserve el código fuente de Mermaid junto con el PNG, porque PNG no conserva los nodos, enlaces, reglas de disposición ni el texto editable.

Si el destino admite gráficos vectoriales, SVG suele ser mejor para diagramas grandes y cambios de tamaño posteriores. Elija PNG cuando la aplicación de destino solo acepte imágenes rasterizadas o cuando se necesite una imagen de tamaño fijo.