Termina el 1 de dic. (PT)
SciFig
Tutoriales··Actualizado

Mermaid a imagen: exporta diagramas SVG, PNG y PDF (2026)

Convierte Mermaid a imagen PNG, SVG o PDF con Mermaid Live Editor, mermaid-cli, VS Code y CI, y corrige los PNG borrosos, diminutos o recortados.

SciFig Team
SciFig Team
Equipo editorial de SciFig

Para pasar de Mermaid a imagen, exporta PNG o SVG desde Mermaid Live Editor o con la CLI mmdc.

Respuesta rápida: para una exportación puntual de Mermaid a imagen, pega el diagrama en Mermaid Live Editor y descarga PNG o SVG desde su panel Actions. Para exportaciones repetibles o por lotes, ejecuta el comando mmdc de mermaid-cli, que convierte un archivo .mmd o Markdown en SVG, PNG o PDF. Si lo que necesitas es una versión editable y lista para revista, SciFig FlowChart (diagramas de flujo) hace que la IA vuelva a dibujar el diagrama a partir de tu descripción, con cada caja, etiqueta y flecha editable, y exporta SVG, PNG o PPTX.
Para guardar un diagrama de Mermaid como imagen sin instalar nada, pega el código en el convertidor de Mermaid a PNG de SciFig: muestra el diagrama en tu navegador, te deja elegir una escala de exportación de 1× a 4× y un fondo blanco o transparente, y descarga PNG o SVG gratis.

Mermaid genera diagramas a partir de texto, lo que facilita mantenerlos junto a la documentación en un sistema de control de versiones. Para obtener un archivo que puedas insertar en un manuscrito, una diapositiva o un póster, tienes que elegir el formato y el tamaño. Si un PNG no tiene suficientes píxeles, puede verse borroso al imprimirlo al tamaño previsto.

ObjetivoMétodoFormatos¿Hay que instalar algo?¿El código sale de tu equipo?
Un diagrama, ahora mismoMermaid Live Editor → Actions → PNG o SVGPNG, SVGNoSí, se pega en una página web alojada
Exportación repetible o por lotesmermaid-cli (mmdc)SVG, PNG, PDFNode.js, o una ejecución puntual con npxNo, se renderiza en local
Vista previa mientras escribes MarkdownExtensión de VS Code u ObsidianVista previa; algunas extensiones exportan SVG/PNGExtensión del editorNo
Documentación siempre al díammdc como paso de compilación en CISVG, PNG, PDFEn el pipelineSe queda en tu CI
Redibujo editable y listo para revistaSciFig FlowChart: describe el diagrama o adjunta el texto de Mermaid como archivo .md, y la IA lo vuelve a dibujar con cada caja, etiqueta y flecha editableSVG, PNG, JPG, PPTXNo, funciona en el navegadorSí, se sube a SciFig

La última fila es otro tipo de herramienta: en lugar de renderizar tu código Mermaid, la IA vuelve a dibujar el diagrama a partir de tu descripción como SVG nativo, de modo que cada nodo, etiqueta y flecha es un elemento que puedes mover, cambiar de estilo y maquetar según las convenciones de una revista. Empiezas gratis, sin tarjeta, con 150 créditos el primer día, y la edición y la exportación a SVG/PNG/PPTX son gratuitas.

Código de un diagrama de flujo de Mermaid junto al SVG resultante (Figura generada con SciFig)
Código de un diagrama de flujo de Mermaid junto al SVG resultante (Figura generada con SciFig)

Exportar desde la línea de comandos

La herramienta oficial es @mermaid-js/mermaid-cli, que incluye el comando mmdc:
npm install -g @mermaid-js/mermaid-cli
 
mmdc -i diagram.mmd -o diagram.svg          # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf          # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3     # raster at 3x scale
Elige SVG o PDF si el destino admite esos formatos. Las líneas y etiquetas vectoriales se pueden ampliar sin perder nitidez; las imágenes de mapa de bits incrustadas conservan su resolución original. Si necesitas PNG, establece un factor de escala y comprueba que las dimensiones en píxeles sean suficientes para el tamaño y la resolución de impresión.
FormatoVectorialRecomendado paraEvítalo si
SVGContenedor vectorialWeb y edición posteriorEl destino no admite SVG
PDFContenedor vectorialManuscritos, impresión y diapositivasEl editor de destino no conserva los elementos que necesitas
PNGNoVistas previas y destinos que exigen mapas de bitsNo tiene suficientes píxeles para el tamaño final
mmdc también lee Markdown. mmdc -i notes.md -o notes-rendered.md renderiza como imagen cada bloque de código mermaid del archivo y escribe una copia del Markdown que apunta a esas imágenes: muy práctico para un README o un cuaderno de laboratorio lleno de diagramas.

Ve la generación de figuras científicas con IA en acción

Observa cómo los investigadores crean figuras científicas listas para publicar a partir de descripciones de texto.

Explorar la herramienta

Cómo exportar Mermaid a PNG (y arreglar resultados borrosos, diminutos o recortados)

Para generar un archivo PNG a partir de un diagrama de Mermaid, da a mmdc un nombre de salida que termine en .png. El PNG se recorta al propio diagrama, y su tamaño depende de dos ajustes: el ancho de página en el que se maqueta el diagrama y el factor de escala. La mayoría de las quejas sobre «PNG malos» se resuelven con alguno de estos arreglos.
PNG borroso: sube la escala. -s multiplica la densidad de píxeles sin cambiar la maquetación. -s 2 sirve para diapositivas; -s 3 o -s 4, para impresión.
mmdc -i diagram.mmd -o diagram.png -s 3
Texto diminuto en un diagrama ancho: amplía la página. -w fija el ancho de página (800 px por defecto) y -H el alto (600 px por defecto). Mermaid reduce un diagrama ancho para que quepa en la página, así que un diagrama de flujo largo de izquierda a derecha puede salir con etiquetas ilegibles. Una página más ancha mantiene las etiquetas a tamaño completo.
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
Resultado recortado o apretado: exporta primero a SVG. Si las etiquetas aparecen cortadas o amontonadas, renderiza un SVG y ábrelo en el navegador. Si el SVG se ve bien, el problema es el tamaño de página o la escala; si también se ve mal, acorta las etiquetas o cambia la dirección (graph TD en lugar de graph LR).
Recuadro blanco detrás del diagrama: usa un fondo transparente. -b fija el fondo para PNG y SVG (no para PDF). El valor por defecto es blanco.
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
Fuente o tema incorrectos: ponlos en un archivo de configuración. -c carga una configuración JSON de Mermaid, de modo que todos los diagramas que exportes compartan fuente y tema. -t elige un tema integrado (default, forest, dark, neutral) para una sola ejecución.
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
Los temas del editor no se exportan. Un tema oscuro de VS Code, el modo oscuro de Obsidian o un tema elegido en la interfaz de un editor solo cambian el aspecto de la vista previa. El archivo exportado usa el tema escrito en el diagrama (una línea init o la cabecera YAML) o el que pases a mmdc. Si la exportación se ve distinta de la vista previa, escribe el tema en el diagrama.
mmdc no se instala: ejecútalo con npx. Las instalaciones globales fallan en equipos bloqueados. npx descarga la CLI en una caché y la ejecuta una vez, sin instalación global. La primera ejecución también descarga un navegador headless, así que tarda unos minutos.
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

Ejemplos de línea temporal y diagrama de secuencia

Estos ejemplos mínimos se exportan con los mismos comandos. Guarda cada uno como archivo .mmd.
Ejemplo de línea temporal (timeline) de Mermaid como imagen PNG:
timeline
    title Research project timeline
    2024 : Grant awarded
    2025 : Pilot study : Data collection
    2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3
Ejemplo de diagrama de secuencia de Mermaid:
sequenceDiagram
    participant R as Researcher
    participant S as Sequencing core
    participant P as Analysis pipeline
    R->>S: Submit samples
    S-->>R: Raw reads
    R->>P: Run QC and alignment
    P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg

Otras formas de exportar

Mermaid Live Editor. El editor del navegador exporta SVG y PNG directamente desde su panel Actions y es la opción más rápida para un diagrama puntual. Al usar un servicio alojado, el texto del diagrama se envía a ese servicio. Para contenido sensible, utiliza la CLI en tu equipo.
Convertidor de Mermaid a PNG de SciFig. Pega el código Mermaid en el convertidor de Mermaid a PNG, genera la vista previa y descarga PNG o SVG. Para un PNG más nítido, elige una escala más alta entre 1× y 4×; para diapositivas con fondo de color, elige el fondo transparente. Si el código tiene un error de sintaxis, la herramienta indica dónde está en lugar de exportar una imagen defectuosa, así que corriges la línea y vuelves a renderizar.
VS Code. Las extensiones de vista previa de Mermaid permiten ver los diagramas mientras escribes. Las opciones de exportación dependen de la extensión; con la CLI anterior puedes elegir expresamente SVG, PNG o PDF.
Integración continua (CI). Como mmdc se ejecuta desde la línea de comandos, puedes incluir el renderizado de diagramas en la compilación. Una práctica habitual es guardar los archivos fuente .mmd en el repositorio y generar las imágenes al compilar la documentación. Así, las imágenes se mantienen al día con el código fuente.
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Proceso de CI que guarda los archivos fuente de Mermaid en el repositorio y genera imágenes al compilar la documentación (Figura generada con SciFig)
Proceso de CI que guarda los archivos fuente de Mermaid en el repositorio y genera imágenes al compilar la documentación (Figura generada con SciFig)

Exportar desde Obsidian y VS Code, y llevarlo a artículos o diapositivas

Obsidian. Obsidian renderiza los bloques de código mermaid en la vista previa de la nota, pero no tiene un botón integrado para guardar un solo diagrama como archivo de imagen. Al exportar la nota a PDF, el diagrama va incluido. Para un PNG o SVG independiente, copia el bloque en Mermaid Live Editor, o guárdalo como archivo .mmd y ejecuta mmdc. Como mmdc lee Markdown, también puedes apuntarlo a la propia nota.
VS Code y vistas previas de Markdown. Una extensión de vista previa de Mermaid muestra el diagrama mientras escribes. Para exportar como PNG en VS Code un diagrama de Mermaid escrito en Markdown, usa una extensión con exportación, o guarda el diagrama en un archivo .mmd junto a tu Markdown y renderízalo con mmdc desde el terminal integrado.
Artículos y diapositivas. Exporta SVG (o PDF para LaTeX), no PNG. En PowerPoint, inserta el SVG como imagen; las versiones recientes pueden convertirlo en formas para que cambies el color de las cajas. En Illustrator o Inkscape, abre el SVG para ajustar espaciado, fuentes y puntas de flecha antes de colocarlo en el manuscrito. Usa PNG a -s 3 o más solo cuando un sistema de envío rechace archivos vectoriales.
El mismo diagrama de flujo de Mermaid con el tema predeterminado y el neutro, para comparar su legibilidad al imprimir (Figura generada con SciFig)
El mismo diagrama de flujo de Mermaid con el tema predeterminado y el neutro, para comparar su legibilidad al imprimir (Figura generada con SciFig)

Ajustar el aspecto del diagrama

La configuración predeterminada de Mermaid está pensada para documentación, no para publicaciones. Conviene ajustar tres aspectos:

  • Tema. Añade theme: neutral dentro de config en la cabecera YAML del diagrama. Antes de elegir un tema para impresión, revisa el resultado al tamaño final.
  • Fuentes. Define fontFamily en la configuración y comprueba que la fuente elegida esté disponible en el entorno de renderizado.
  • Dirección. Usar graph LR o graph TD cambia la relación de aspecto. Esto puede marcar la diferencia cuando necesitas encajar el diagrama en una columna.

Un diagrama de flujo de un proceso de investigación con tema neutro y una fuente apta para impresión:

---
config:
  theme: neutral
  fontFamily: Helvetica
---
graph LR
  A[Sample collection] --> B[Extraction]
  B --> C[Sequencing]
  C --> D[Analysis]

Cuándo conviene usar otra herramienta

Mermaid calcula automáticamente la distribución de los elementos y deja poco margen para ajustarla. Es una ventaja en la documentación, pero limita las figuras científicas en las que la composición transmite información.

Mermaid encajaCambia a SciFig FlowChart o a un editor vectorial
Documentación que vive en el control de versionesUna figura de manuscrito que debe seguir las convenciones visuales de una revista
Diagramas que se regeneran en cada compilaciónUna disposición espacial precisa que controlas caja a caja
La maquetación automática es suficientePosiciones que reflejan relaciones reales, como la ubicación anatómica o una secuencia temporal
Código fuente solo texto que se compara en revisiónCoautores que editan la figura visualmente en lugar de en código

Una opción intermedia es crear la estructura en Mermaid, exportarla a SVG y terminarla en un editor vectorial. Ten en cuenta que esos retoques no se reproducirán al volver a generar el diagrama desde el código fuente.

Distribución automática de Mermaid junto al mismo contenido reorganizado manualmente como figura para un manuscrito (Figura generada con SciFig)
Distribución automática de Mermaid junto al mismo contenido reorganizado manualmente como figura para un manuscrito (Figura generada con SciFig)
Otra vía es un redibujo en SciFig FlowChart. Describe el diagrama en lenguaje natural, o adjunta tu texto de Mermaid como archivo .md, y el generador de diagramas a partir de texto hace que la IA dibuje una versión editable como SVG nativo, en la que cada caja, etiqueta y flecha puede moverse y cambiar de estilo directamente. Para una interacción como el ejemplo de secuencia anterior, el generador de diagramas de secuencia hace lo mismo con participantes y mensajes. Empiezas gratis con 150 créditos el primer día, y editar, guardar y exportar SVG, PNG o PPTX es gratuito. Si estás valorando herramientas de diseño basadas en plantillas para la misma tarea, consulta nuestras alternativas a Canva para diagramas.

Consejo

Guarda el archivo fuente .mmd junto a la imagen exportada en el mismo commit. El código permite revisar los cambios y regenerar el diagrama; la imagen permite consultar el resultado directamente. Si conservas solo uno de los dos, pierdes la facilidad de revisión o de consulta.

Crea figuras científicas ahora

Describe tu figura científica en lenguaje natural — obtén ilustraciones listas para publicar en minutos.

Probar gratis
Para figuras de publicación que van más allá de los diagramas, la herramienta de texto a figura de SciFig se encarga de las ilustraciones. Encontrarás el proceso completo en nuestra guía para visualizar tu investigación.

Lecturas relacionadas

Lecturas relacionadas: Visualiza la investigación al instante con IA Texto a Figura, 10 mejores herramientas de ilustración científica en 2026, Alternativa gratis a Canva: 7 opciones para diagramas (2026).

Preguntas frecuentes

Sigue avanzando

Recursos recomendados

Plantillas, herramientas y lecturas adicionales para tu investigación

Fondo de llamada a la acción

¿Listo para empezar?

Figuras científicas listas para publicar, en minutos

Empezar gratis

Gratis para empezar · Sin tarjeta de crédito · Pensado para investigadores