Mermaid a PDF
Convierte un diagrama Mermaid a PDF, con el Markdown alrededor
Escribe tu diagrama de flujo, de secuencia o de Gantt en un bloque de código mermaid y MDPress lo dibuja. El diagrama aparece en la vista previa en vivo y llega al PDF como arte vectorial, así que las líneas se mantienen nítidas a cualquier zoom. Sin instalar nada, sin línea de comandos y sin cuenta para tus primeros cuatro PDF al día.
Abrir el conversorDe un bloque mermaid a un PDF en tres pasos
- 01
Pega tu Markdown
Pega el documento en el editor, o sube un archivo .md. Mantén cada diagrama en un bloque de código que empiece con tres comillas invertidas y la palabra mermaid, igual que espera GitHub.
- 02
Revisa el diagrama en la vista previa
La vista previa dibuja cada diagrama mientras escribes. Si la sintaxis tiene un error, el bloque se muestra como código plano en su lugar, así puedes ver la línea rota y corregirla antes de exportar.
- 03
Elige un estilo y descarga
Elige Limpio, Editorial o Técnico, y luego A4, A5 o US Letter. Presiona el botón de PDF y el archivo se descarga con tus diagramas incrustados y el texto alrededor seleccionable.
Un archivo Markdown con un diagrama de flujo Mermaid
Esta breve nota de proceso tiene un diagrama de flujo entre dos fragmentos de Markdown normal.
# Proceso de lanzamiento Cada cambio sigue el mismo camino desde la revisión hasta producción. ```mermaid flowchart LR A[Abrir pull request] --> B[Revisión de código] B --> C[Ejecutar pruebas] C --> D[Desplegar a staging] D --> E[Lanzamiento] ``` ## Notas - Las revisiones necesitan una aprobación. - Las pruebas se ejecutan en cada push. - Staging usa la misma configuración que producción.
Proceso de lanzamiento
Cada cambio sigue el mismo camino desde la revisión hasta producción.
flowchart LR
A[Abrir pull request] --> B[Revisión de código]
B --> C[Ejecutar pruebas]
C --> D[Desplegar a staging]
D --> E[Lanzamiento]Notas
- Las revisiones necesitan una aprobación.
- Las pruebas se ejecutan en cada push.
- Staging usa la misma configuración que producción.
Por qué convertir diagramas Mermaid aquí
Vectorial, no una captura de pantalla
Cada diagrama entra al PDF como arte vectorial en lugar de una imagen de mapa de bits. Acércate a un diagrama de flujo denso o imprímelo en papel y las líneas y las etiquetas se mantienen nítidas.
El diagrama y el documento juntos
La mayoría de las herramientas de Mermaid exportan una sola imagen. Aquí el diagrama vive dentro del documento completo, junto a tus títulos, tablas y código resaltado, así que una especificación o una nota de diseño se entrega como un solo archivo.
Diagramas que no se dividen
Un diagrama se reduce para caber en el ancho de la página, y el diseño evita partirlo entre dos páginas. Si uno cae en un mal lugar, pon una línea con \newpage encima para empezar una página nueva.
Consejos para diagramas limpios
- Mantén las etiquetas de los nodos cortas y sencillas. Las etiquetas largas producen un diagrama ancho, y un diagrama ancho se reduce para caber en la página, lo que encoge su texto.
- Los diagramas grandes se leen mejor en A4 o US Letter que en A5. Para una cadena larga de pasos, prueba un diagrama de flujo de arriba a abajo para aprovechar la altura de la página.
- Si un bloque se muestra como código en la vista previa, la sintaxis Mermaid tiene un error. El PDF mostrará el mismo bloque de código, así que corrígelo antes de descargar.
Preguntas sobre Mermaid a PDF
- ¿Cómo convierto un diagrama Mermaid a PDF?
- Pon el diagrama en un bloque de código marcado como mermaid, pégalo en MDPress y presiona el botón de PDF. El diagrama puede ser todo el documento o una sola parte de un archivo Markdown más largo. Ambos casos funcionan igual.
- ¿Qué tipos de diagramas Mermaid son compatibles?
- MDPress ejecuta la librería estándar de Mermaid en tu navegador, así que se dibujan diagramas de flujo, de secuencia, de clases, de estados, de Gantt y los demás tipos incorporados. Si un diagrama se muestra en la vista previa, estará en el PDF.
- ¿Es gratis, y se guarda mi diagrama?
- Tienes cuatro PDF gratis cada 24 horas sin cuenta y cinco con una cuenta gratuita. Tu texto se envía al servidor una vez para crear el PDF y no se guarda. El borrador en sí se queda en tu navegador.
Convierte tu Markdown con Mermaid en un PDF
Pega un documento con un bloque mermaid y observa cómo aparece el diagrama en la vista previa.