Convertisseur en ligne gratuit de MERMAID en PNG

PNG est utile lorsqu’un diagramme Mermaid doit être inséré dans un document, une présentation, un outil de suivi des problèmes ou une archive basée sur des images qui ne peut pas afficher le code source Mermaid. La conversion crée également un instantané visuel fixe à partager, tandis que le fichier Mermaid original reste modifiable.

Qu’est-ce que le format MERMAID ?

Un fichier MERMAID est une définition de diagramme en texte brut, généralement enregistrée avec l’extension .mermaid ou .mmd. Il contient la syntaxe Mermaid pour les organigrammes, les cartes mentales, les diagrammes de séquence, les diagrammes de classes, les diagrammes d’états, les diagrammes entité-association et autres graphiques structurés, plutôt que des pixels enregistrés.

Les fichiers Mermaid sont créés ou modifiés dans Mermaid Live Editor, Mermaid CLI, Visual Studio Code avec des extensions Mermaid, ainsi que dans des applications telles qu’Obsidian, GitLab et GitHub qui prennent en charge le rendu Mermaid. Vous pouvez en rencontrer un lorsqu’un diagramme est stocké dans un dépôt de code source, un document Markdown, une application de prise de notes ou un projet de documentation.

Qu’est-ce que le format PNG ?

PNG est un format d’image matricielle pris en charge par les navigateurs web, les logiciels bureautiques, les outils de présentation, les visionneuses d’images et la plupart des systèmes de documents. Il utilise une compression sans perte, préserve mieux que JPEG les lignes nettes de couleur unie et le texte, et peut stocker des arrière-plans transparents.

PNG convient lorsque le destinataire a besoin d’une image ordinaire plutôt que de la syntaxe Mermaid. Il n’est pas idéal pour modifier des éléments individuels du diagramme ou pour des diagrammes extrêmement volumineux, car l’agrandissement d’une image matricielle peut donner un aspect pixellisé au texte et aux lignes.

Comment convertir MERMAID en PNG

Utilisation de 101convert en ligne

1. Ouvrez le convertisseur MERMAID vers PNG sur 101convert.com.
2. Téléversez le fichier .mermaid ou .mmd.
3. Lancez la conversion et téléchargez le fichier .png généré.

Cette option ne nécessite aucun logiciel installé et convient lorsque le fichier Mermaid ne contient pas d’informations sensibles.

Utilisation de Mermaid CLI

Pour effectuer des conversions locales reproductibles, installez Mermaid CLI avec Node.js :

npm install -g @mermaid-js/mermaid-cli

Effectuez le rendu d’un fichier source avec :

mmdc -i diagram.mermaid -o diagram.png

L’entrée peut également utiliser l’extension .mmd. Pour augmenter la résolution matricielle, appliquez un facteur d’échelle :

mmdc -i diagram.mmd -o diagram.png -s 2

Utilisez une couleur d’arrière-plan lorsque la transparence ne convient pas :

mmdc -i diagram.mmd -o diagram.png -b white

Mermaid CLI effectue le rendu du code source avec un navigateur sans interface graphique. Si l’installation signale un problème lié à Chromium ou au navigateur, suivez les instructions de configuration du navigateur correspondant à la version de Mermaid CLI avant de relancer la commande.

Utilisation d’un éditeur de diagrammes

Ouvrez le code source dans Mermaid Live Editor ou dans un autre éditeur compatible avec Mermaid, vérifiez que l’aperçu s’affiche correctement, puis choisissez Export → PNG ou la commande d’exportation d’image équivalente. Les paramètres d’exportation peuvent permettre de définir un arrière-plan transparent, de sélectionner un thème ou d’ajuster l’échelle.

Considérations relatives à la qualité et à la compatibilité

Le fichier PNG reflète le moteur de rendu Mermaid, la version de Mermaid, le thème, les polices disponibles et les paramètres d’initialisation utilisés lors de l’exportation. Un diagramme peut donc avoir un aspect différent lorsqu’il est rendu par une autre application ou une autre version.

Augmentez l’échelle d’exportation pour les diagrammes contenant de petites étiquettes : modifier la largeur du fichier PNG après l’exportation ne permet pas de récupérer les détails perdus. Conservez le code source Mermaid original avec le fichier PNG, car PNG ne conserve ni les nœuds, ni les liens, ni les règles de mise en page, ni le texte modifiable.

Si la destination prend en charge les graphiques vectoriels, SVG est généralement préférable pour les grands diagrammes et les redimensionnements ultérieurs. Choisissez PNG lorsque l’application cible n’accepte que les images matricielles ou lorsqu’une image de taille fixe est requise.