Mensagens de erro Mermaid costumam indicar onde a análise parou, não onde o erro começou. Um terminador ou uma aspa ausente pode fazer a linha válida seguinte parecer culpada. Reduzir o código é mais rápido do que trocar pontuação ao acaso.
Confirme primeiro o tipo de diagrama
A primeira linha que não é comentário seleciona o analisador: flowchart LR, sequenceDiagram, erDiagram ou gantt. Sintaxe válida em um tipo não serve automaticamente em outro. Confira maiúsculas e remova cercas Markdown ao usar um editor de fonte pura.
Reduza ao menor exemplo renderizável
Mantenha a primeira linha e uma instrução conhecida. Se funcionar, devolva metade das instruções removidas e repita.
flowchart LR
A[Início] --> B[Fim]Se o mínimo falhar, redigite as linhas. Aspas tipográficas, espaços inseparáveis e pontuação Unicode podem passar despercebidos.
Confira estrutura e tokens reservados
subgraph, alt, loop e opt exigem end. Em fluxogramas, end minúsculo pode virar sintaxe. IDs alfanuméricos estáveis e textos entre colchetes ou aspas reduzem ambiguidades.
Considere versão e configuração
Integrações usam versões e políticas de segurança diferentes. Teste no aplicativo que publicará o diagrama e informe uma versão mínima para sintaxe avançada. HTML e links interativos podem estar desativados separadamente.
Preserve uma falha reproduzível
Inclua fonte mínima, versão Mermaid, navegador, modo de segurança e resultado esperado. Remova dados confidenciais. O editor Mermaid do DevToy mostra a mensagem local e ajuda a reduzir o caso.