Les messages Mermaid indiquent souvent où l’analyse s’est arrêtée, pas où l’erreur a commencé. Un terminateur ou un guillemet manquant peut incriminer la ligne valide suivante. Réduire la source est plus rapide que modifier la ponctuation au hasard.
Confirmer d’abord le type de diagramme
La première ligne non commentée choisit le parseur : flowchart LR, sequenceDiagram, erDiagram ou gantt. Une syntaxe valide dans un type ne l’est pas automatiquement dans un autre. Vérifiez la casse et retirez les clôtures Markdown dans un éditeur brut.
Réduire au plus petit exemple rendu
Gardez la première ligne et une instruction connue. Si elle fonctionne, réintroduisez la moitié du code supprimé et répétez.
flowchart LR
A[Début] --> B[Fin]Si le minimum échoue, retapez les lignes : guillemets typographiques, espaces insécables et ponctuation Unicode peuvent être invisibles.
Vérifier structure et mots réservés
subgraph, alt, loop et opt ont besoin d’un end. Dans les organigrammes, end en minuscules peut être interprété comme une syntaxe. Des ID alphanumériques stables et des libellés entre crochets réduisent les ambiguïtés.
Tenir compte de la version et de la configuration
Les intégrations embarquent des versions et règles de sécurité différentes. Testez dans l’application de publication et indiquez une version minimale pour la syntaxe avancée. HTML et liens interactifs peuvent être désactivés séparément.
Conserver un échec reproductible
Incluez la source minimale, la version Mermaid, le navigateur, le mode de sécurité et le résultat attendu. Retirez les données confidentielles. L’éditeur Mermaid DevToy affiche l’erreur localement et facilite la réduction.