Exporta un flujo Mermaid que se entienda
Crea un pequeño flujo de revisión Mermaid, comprueba sus ramas y su retorno y exporta un diagrama legible para compartir.
Un buen diagrama permite seguir una decisión sin pedir al autor que explique cada flecha. Empieza en Mermaid a imagen con un proceso pequeño que puedas verificar. Aquí usamos un ciclo de revisión: un borrador supera la comprobación de hechos o vuelve para corregirse.
Anota primero el inicio, la decisión y el resultado. El ejemplo tiene cuatro nodos: preparar la fuente, comprobar los hechos, exportar y corregir. La corrección vuelve a la misma decisión. Ese retorno importa: sin él, la imagen sugeriría que corregir termina el proceso.
Asigna identificadores estables a los nodos y usa sus etiquetas visibles para describir el trabajo. Draft y Review son identificadores; las frases dentro de las formas son las etiquetas. La documentación de flujos Mermaid explica esta distinción y la sintaxis de dirección.
La primera línea establece un flujo de izquierda a derecha. Las dos ramas etiquetadas hacen explícita la decisión sin depender solo del color. Es un proceso de demostración, no una prueba de que un lanzamiento real haya superado la revisión.
Usa la imagen en una entrega editorial o un documento breve de proceso. Recorre las dos rutas: la aprobada llega a exportar y la otra pasa por corregir y regresa a comprobar los hechos.
Si el renderizado falla, comprueba primero los corchetes y llaves de etiquetas y formas. Reduce el diagrama a la primera conexión y añade las demás líneas de una en una. Así acotas el problema sin cambiar todas las decisiones de diseño a la vez.
Si aparece un nodo inesperado, compara su identificador con el previsto. Reutilizar el mismo identificador conecta con el mismo nodo; una errata puede describir uno diferente. Si el gráfico se genera pero las flechas apuntan al paso incorrecto, la sintaxis puede ser válida aunque el proceso esté mal. Léelo en voz alta como una secuencia de decisiones.
Mantén breves las etiquetas de las ramas y procura que el diagrama se lea en su destino. Un proceso horizontal ancho puede necesitar una disposición vertical o varios diagramas pequeños para una página estrecha. Revisa la composición después de cambiar la dirección.
Inspecciona el archivo descargado para detectar etiquetas cortadas y puntas de flecha ambiguas. Incluye un resumen textual y conserva la fuente Mermaid para editarla después. Exporta tu diagrama Mermaid revisado cuando todas las rutas tengan sentido.
Guías relacionadas: evitar errores habituales de Markdown y crear tablas Markdown legibles.