Rendu ASCII

Le mode ASCII transforme votre diagramme Mermaid en art textuel — parfait pour les commentaires de code, les fichiers README, les descriptions de pull request, la sortie de terminal, ou partout où une image ne peut pas aller.

Passer en mode ASCII

Cliquez sur ASCII dans le sélecteur de mode de la barre de navigation (ou ouvrez directement /ascii). Le même code Mermaid dans l’éditeur est rendu en caractères au lieu d’un SVG :

┌───────┐      ┌────────┐
│ Start │─────▶│ Ship it│
└───────┘      └────────┘

Le rendu ASCII est propulsé par beautiful-mermaid, un portage TypeScript de mermaid-ascii. Le moteur de rendu est chargé à la demande : il n’est téléchargé qu’à la première ouverture du mode ASCII.

Paramètres

Avec le mode ASCII actif, le panneau de droite affiche les paramètres ASCII :

• Jeu de caractères — Unicode ─│┌ utilise des caractères de dessin de cadres pour des lignes et des coins nets ; ASCII - | + limite la sortie aux caractères ASCII simples pour une compatibilité maximale (anciens terminaux, outils de revue de code, e-mails en texte brut).
• Taille de police — met à l’échelle le texte rendu, utile pour faire tenir un grand diagramme dans un bloc de commentaire étroit.

Types de diagrammes pris en charge

Les organigrammes et diagrammes de séquence donnent les meilleurs résultats. Certains types de diagrammes Mermaid ne sont pas encore pris en charge par le moteur ASCII — pour ceux-là, l’aperçu affiche un message de repli localisé au lieu d’un rendu cassé.

Les liens très longs (---->) sont normalisés automatiquement avant le rendu, de sorte que les diagrammes aux arêtes étirées produisent tout de même un résultat cohérent.

Exportation

En mode ASCII, la boîte de dialogue d’export propose TXT (texte brut) — le diagramme texte rendu, prêt à être collé partout. Voir Exporter et partager.

Parcourir les modèles ASCII

Ouvrez /ascii/templates pour parcourir la galerie de modèles rendue en art ASCII. Les modèles non pris en charge sont filtrés automatiquement, et les puces de filtre par type vous aident à trouver un point de départ. Voir Modèles.