Los mensajes de Mermaid suelen señalar dónde se detuvo el análisis, no dónde comenzó el error. Un cierre de bloque o una comilla ausente puede hacer culpable a la siguiente línea válida. Reducir el código es más rápido que cambiar signos al azar.
Confirma primero el tipo de diagrama
La primera línea que no sea comentario selecciona un analizador: flowchart LR, sequenceDiagram, erDiagram o gantt. Una sintaxis válida en un tipo no tiene por qué servir en otro. Comprueba mayúsculas y elimina las cercas Markdown al pegar en un editor de código puro.
Reduce al ejemplo mínimo que renderice
Conserva la primera línea y una sentencia conocida. Si funciona, devuelve la mitad de lo eliminado y repite hasta aislar la región problemática.
flowchart LR
A[Inicio] --> B[Fin]Si sigue fallando, vuelve a escribir las líneas: comillas tipográficas, espacios no separables y puntuación Unicode pueden pasar inadvertidos.
Revisa estructura y tokens reservados
Todo bloque necesita cierre: subgraph, alt, loop y opt terminan con end. En un diagrama de flujo, end en minúsculas puede interpretarse como sintaxis. Usa ID alfanuméricos estables y coloca el texto visible entre corchetes o comillas.
Considera versión y configuración
Distintas integraciones incluyen diferentes versiones y políticas de seguridad. Prueba en la aplicación que publicará el diagrama e indica una versión mínima para sintaxis avanzada. HTML o enlaces interactivos pueden estar desactivados aunque el diagrama básico sea válido.
Conserva un fallo reproducible
Incluye código mínimo, versión Mermaid, navegador, modo de seguridad y resultado esperado. Elimina nombres confidenciales. El editor Mermaid de DevToy muestra el error localmente y ayuda a reducir el caso.