Mermaid-Fehlermeldungen zeigen oft die Stelle, an der der Parser anhielt, nicht den Beginn des Fehlers. Ein fehlendes Blockende oder Anführungszeichen kann die folgende gültige Zeile verdächtig erscheinen lassen. Reduzieren ist schneller als zufälliges Ändern von Satzzeichen.
Zuerst den Diagrammtyp bestätigen
Die erste Nicht-Kommentarzeile wählt den Parser: flowchart LR, sequenceDiagram, erDiagram oder gantt. Syntax eines Typs gilt nicht automatisch für andere. Prüfen Sie Großschreibung und entfernen Sie Markdown-Codezäune in einem Rohtexteditor.
Auf das kleinste rendernde Beispiel reduzieren
Behalten Sie die erste Zeile und eine bekannte gültige Anweisung. Funktioniert sie, fügen Sie jeweils die Hälfte des entfernten Codes zurück.
flowchart LR
A[Start] --> B[Ende]Schreiben Sie die Zeilen neu, wenn das Minimum scheitert. Typografische Anführungszeichen und geschützte Leerzeichen sind visuell schwer erkennbar.
Struktur und reservierte Token prüfen
subgraph, alt, loop und opt benötigen ein end. In Flussdiagrammen kann das kleingeschriebene Wort end als Syntax gelten. Stabile alphanumerische IDs und Beschriftungen in Klammern vermeiden Mehrdeutigkeit.
Version und Konfiguration berücksichtigen
Integrationen bündeln unterschiedliche Mermaid-Versionen und Sicherheitsregeln. Testen Sie im späteren Publikationssystem und dokumentieren Sie eine Mindestversion für neue Syntax. HTML-Beschriftungen oder interaktive Links können separat deaktiviert sein.
Einen reproduzierbaren Fehler bewahren
Ein Bericht braucht minimalen Quelltext, Mermaid-Version, Browser, Sicherheitsmodus und erwartetes Ergebnis. Entfernen Sie vertrauliche Daten. Der DevToy-Mermaid-Editor zeigt lokale Parsermeldungen und hilft beim Eingrenzen.