Convertisseur en ligne gratuit de MMD en PNG

Qu’est-ce que le format MMD ?

Dans le contexte des cartes mentales et des organigrammes, .mmd est un fichier de diagramme Mermaid en texte brut. Il contient une syntaxe Mermaid décrivant les nœuds, les connexions, les libellés, les directions et les types de diagrammes tels que les organigrammes, les cartes mentales, les diagrammes de séquence et les diagrammes de classes.

Les éditeurs Mermaid, les systèmes de documentation, les dépôts de code et les flux de travail de création de diagrammes créent ou utilisent des fichiers MMD. Un fichier classique contient du code source tel que flowchart TD; A[Start] --> B[Finish], plutôt que des pixels pré-rendus. Le fichier peut être modifié avec n’importe quel éditeur de texte, mais il nécessite un moteur de rendu compatible avec Mermaid pour produire une image.

Qu’est-ce que le format PNG ?

PNG est un format d’image matricielle pris en charge par les navigateurs web, les applications bureautiques, les éditeurs d’images, les logiciels de présentation et la plupart des systèmes d’exploitation. Il convient aux diagrammes, car il utilise une compression sans perte, conserve des contours nets aux couleurs unies et prend en charge la transparence.

Utilisez PNG lorsque la destination accepte les images, mais n’interprète pas la syntaxe Mermaid, ou lorsque vous avez besoin d’un instantané visuel fixe pour de la documentation, des e-mails, des présentations ou de l’archivage. PNG n’est pas idéal pour une mise à l’échelle illimitée ; SVG est généralement préférable lorsque le diagramme doit rester parfaitement net, quelle que soit sa taille.

Comment convertir MMD en PNG

Utilisation du convertisseur en ligne intégré

Vous pouvez convertir le fichier gratuitement sur 101convert.com, sans installer de logiciel. Téléversez le fichier .mmd, sélectionnez PNG comme format de sortie si vous y êtes invité, démarrez la conversion, puis téléchargez l’image rendue. Le fichier source doit contenir une syntaxe Mermaid valide ; un fichier contenant du texte sans rapport ou une syntaxe non prise en charge peut ne pas être rendu.

Utilisation de Mermaid CLI

Mermaid CLI est la méthode de bureau ou en ligne de commande la plus directe :

1. Installez Node.js, puis installez Mermaid CLI avec npm install -g @mermaid-js/mermaid-cli.
2. Enregistrez le code source Mermaid dans un fichier tel que diagram.mmd.
3. Rendez-le avec mmdc -i diagram.mmd -o diagram.png.

La commande lit le code source Mermaid, le rend à l’aide d’un moteur de navigateur, puis écrit la sortie PNG. Les options utiles comprennent -b transparent pour un arrière-plan transparent, -s 2 pour un facteur d’échelle de deux, -w 2000 pour définir une largeur cible et -H 1200 pour définir une hauteur cible. Par exemple :

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

Sur les systèmes où les dépendances de Chromium ne sont pas disponibles, Mermaid CLI peut nécessiter les paquets du système d’exploitation utilisés par son moteur de navigateur Puppeteer. Une configuration de rendu peut être fournie avec -p puppeteer-config.json.

Limitations de qualité et de compatibilité

La sortie PNG contient uniquement l’apparence rendue ; les positions des nœuds, les liens, les libellés et la syntaxe Mermaid ne peuvent pas être modifiés en tant qu’objets de diagramme. Conservez le fichier .mmd original avec le PNG lorsque de futures modifications sont probables.

Le rendu peut différer selon les versions de Mermaid, car la syntaxe des diagrammes, les thèmes par défaut, les polices et les algorithmes de mise en page évoluent. Installez une version compatible de Mermaid CLI et vérifiez les polices personnalisées sur la machine de rendu. Augmentez -s, -w ou -H lorsque les petits libellés semblent flous, mais évitez d’agrandir un PNG basse résolution après la conversion.