Visualizzare diagrammi Mermaid

Chiedi all’agente un diagramma Mermaid. Quando la risposta contiene un blocco mermaid, Kora renderizza il diagramma nella chat accanto al sorgente.

Tipi supportati

Tutti i tipi di diagramma Mermaid standard vengono renderizzati:

• Flowchart — processi, alberi decisionali, algoritmi
• Sequence diagram — interazioni, chiamate API
• Class diagram — modelli dati, gerarchie
• ER diagram — relazioni tra entità
• Gantt — timeline, piani di progetto
• State diagram — macchine a stati, workflow
• Journey diagram — percorsi utente
• Mindmap — brainstorming, idee
• Gitgraph — storie di branch
• Timeline — eventi cronologici
• Quadrant chart — matrici di priorità
• XY chart — grafici a barre/linee

Quando un diagramma fallisce

Se la sintassi Mermaid contiene un errore, il codice sorgente è mostrato accanto al messaggio di errore restituito dal renderer. Copia il sorgente, correggi l’errore e chiedi di nuovo all’agente — il diagramma corretto sostituisce quello fallito.

Risoluzione problemi

• Il diagramma appare come codice grezzo → il blocco recintato manca del tag lingua mermaid, oppure la sintassi non è stata interpretata. Conferma che la recinzione legga ```mermaid.
• Il diagramma è tagliato → i diagrammi grandi sono scalati per stare nella larghezza della chat. Tasto destro → apri l’immagine in una nuova scheda per la versione intera.
• Le etichette dei nodi con caratteri speciali si rompono → avvolgi le etichette contenenti (), [] o {}: tra virgolette (ad esempio ["Etichetta (con parentesi)"]).
• Il tema sembra sbagliato → i diagrammi sono renderizzati con il tema Kora corrente; cambiare tema rigenera il diagramma al prossimo render.