Blocs Mermaid

Ajoutez un bloc Mermaid pour créer des diagrammes dans GitBook à l’aide de la syntaxe Mermaid

Les blocs Mermaid vous permettent de créer des diagrammes à l'aide de la Mermaid syntaxe.

Utilisez-les lorsque vous souhaitez afficher des flux, des séquences, des états ou des relations dans un format facile à mettre à jour.

Ajouter un bloc Mermaid

1. Placez votre curseur sur une ligne vide et tapez /.
2. Cliquez sur Mermaid dans le menu d’insertion.
3. Saisissez ou collez votre syntaxe Mermaid. GitBook affiche automatiquement le diagramme.

Vous pouvez également cliquer sur le + à gauche de n'importe quelle ligne dans l'éditeur, puis cliquer sur Mermaid.

Exemple

Représentation en Markdown

```mermaid
flowchart TD
    A[Ouvrez la palette d'insertion] --> B[Sélectionnez Mermaid]
    B --> C[Ajoutez la syntaxe Mermaid]
    C --> D[GitBook affiche le diagramme]
```

GitBook rend les blocs de code avec l'identifiant de langue mermaid comme des blocs Mermaid natifs.

Dépannage

Si votre diagramme Mermaid ne s'affiche pas, vérifiez ces causes courantes :

• Erreurs de syntaxe — vérifiez votre code Mermaid pour repérer d'éventuelles fautes de frappe, comparez-le avec les exemples de la documentation Mermaid, ou testez-le dans le Mermaid Live Editor pour isoler le problème.
• Bloc de code au lieu d'un bloc Mermaid — le code Mermaid ne s'affichera pas dans un bloc de code standard. Appuyez sur / et sélectionnez Diagramme Mermaid pour insérer le bon type de bloc.
• Ancien contenu Mermaid — Mermaid est un bloc natif, donc aucune intégration n'est nécessaire. Si vous avez créé du contenu Mermaid avant la prise en charge des blocs natifs, GitBook le convertit automatiquement la prochaine fois que vous modifiez la page.