Fin le 1er déc. (PT)
SciFig
Tutoriels··Mis à jour

Mermaid to PNG : exporter en SVG, PNG et PDF (2026)

Mermaid to PNG : exportez vos diagrammes en PNG, SVG ou PDF avec Mermaid Live Editor, mermaid-cli, VS Code ou la CI, et corrigez les PNG flous ou rognés.

SciFig Team
SciFig Team
Équipe éditoriale de SciFig

Pour exporter un diagramme Mermaid en image, utilisez Mermaid Live Editor ou la CLI mmdc (PNG ou SVG).

Réponse rapide : pour un export ponctuel de Mermaid en image, collez le diagramme dans Mermaid Live Editor et téléchargez le PNG ou le SVG depuis son panneau Actions. Pour des exports répétés ou par lots, lancez la commande mmdc de mermaid-cli, qui convertit un fichier .mmd ou Markdown en SVG, PNG ou PDF. Si vous avez plutôt besoin d’une version modifiable et prête pour une revue, SciFig FlowChart (logigrammes et diagrammes) fait redessiner le diagramme par l’IA à partir de votre description, chaque bloc, libellé et flèche restant modifiable, puis exporte en SVG, PNG ou PPTX.
Pour enregistrer un diagramme Mermaid en image sans rien installer, collez le code dans le convertisseur Mermaid en PNG de SciFig : il affiche le diagramme dans votre navigateur, vous laisse choisir une échelle d’export de 1× à 4× et un fond blanc ou transparent, puis télécharge gratuitement le PNG ou le SVG.

Mermaid transforme du texte en diagrammes : ses fichiers sources se prêtent donc bien à une documentation suivie dans un système de gestion de versions. Pour intégrer le résultat à un article, une diapositive ou un poster, il faut toutefois choisir le format et les dimensions à l’export. Un PNG trop petit en pixels risque de manquer de netteté une fois imprimé à la taille prévue.

ObjectifMéthodeFormatsInstallationLe code quitte-t-il votre machine ?
Un diagramme, tout de suiteMermaid Live Editor → Actions → PNG ou SVGPNG, SVGNonOui, collé dans une page web hébergée
Export répété ou par lotsmermaid-cli (mmdc)SVG, PNG, PDFNode.js, ou exécution ponctuelle avec npxNon, rendu en local
Aperçu pendant la rédaction MarkdownExtension VS Code ou ObsidianAperçu ; certaines extensions exportent en SVG/PNGExtension de l’éditeurNon
Documentation toujours à jourmmdc comme étape de compilation en CISVG, PNG, PDFDans le pipelineReste dans votre CI
Version redessinée, modifiable et prête pour une revueSciFig FlowChart : décrivez le diagramme, ou joignez le texte Mermaid en fichier .md, et l’IA le redessine avec chaque bloc, libellé et flèche modifiableSVG, PNG, JPG, PPTXNon, fonctionne dans le navigateurOui, envoyé à SciFig

La dernière ligne correspond à un autre type d’outil : au lieu de rendre votre code Mermaid, l’IA redessine le diagramme à partir de votre description en SVG natif, si bien que chaque nœud, libellé et flèche devient un élément que vous pouvez déplacer, restyler et disposer selon les conventions d’une revue. Le service est gratuit pour commencer, sans carte bancaire, avec 150 crédits le premier jour, et l’édition ainsi que l’export SVG/PNG/PPTX sont gratuits.

Code source d’un logigramme Mermaid et rendu SVG côte à côte (figure générée avec SciFig)
Code source d’un logigramme Mermaid et rendu SVG côte à côte (figure générée avec SciFig)

Exporter depuis la ligne de commande

L’outil officiel, @mermaid-js/mermaid-cli, s’utilise avec la commande mmdc :
npm install -g @mermaid-js/mermaid-cli
 
mmdc -i diagram.mmd -o diagram.svg          # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf          # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3     # raster at 3x scale
Privilégiez le SVG ou le PDF si le support de destination les accepte. Les traits et les textes vectoriels restent nets à l’agrandissement ; les images matricielles intégrées conservent, elles, leur résolution d’origine. Pour un PNG, réglez le facteur d’échelle, puis vérifiez que les dimensions obtenues en pixels conviennent à la taille et à la résolution d’impression demandées.
FormatVectorielUsages adaptésÀ éviter si…
SVGConteneur vectorielWeb et retouches ultérieuresLe support de destination n’accepte pas le SVG
PDFConteneur vectorielArticles, impression et diapositivesLe logiciel utilisé ensuite ne conserve pas les éléments nécessaires
PNGNonAperçus et supports exigeant une image matricielleLes dimensions en pixels sont insuffisantes pour la taille finale
mmdc lit aussi le Markdown. mmdc -i notes.md -o notes-rendered.md rend chaque bloc de code mermaid du fichier en image et écrit une copie du Markdown qui pointe vers ces images — pratique pour un README ou un cahier de laboratoire rempli de diagrammes.

Voyez la génération de figures scientifiques par IA en action

Observez comment les chercheurs créent des figures scientifiques prêtes à publier à partir de descriptions textuelles.

Explorer l'outil

Exporter Mermaid en PNG (et corriger un rendu flou, minuscule ou rogné)

Pour produire un fichier PNG à partir d’un diagramme Mermaid, donnez à mmdc un nom de sortie qui se termine par .png. Le PNG est recadré sur le diagramme lui-même, et sa taille dépend de deux réglages : la largeur de page dans laquelle le diagramme est mis en page et le facteur d’échelle. La plupart des « mauvais PNG » se règlent avec l’une des corrections ci-dessous.
PNG flou : augmentez l’échelle. -s multiplie la densité de pixels sans modifier la mise en page. -s 2 convient aux diapositives, -s 3 ou -s 4 à l’impression.
mmdc -i diagram.mmd -o diagram.png -s 3
Texte minuscule dans un diagramme large : élargissez la page. -w définit la largeur de page (800 px par défaut) et -H sa hauteur (600 px par défaut). Mermaid réduit un diagramme large pour le faire tenir dans la page, si bien qu’un long logigramme de gauche à droite peut sortir avec des libellés illisibles. Une page plus large conserve les libellés en taille réelle.
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
Rendu rogné ou tassé : exportez d’abord en SVG. Si des libellés sont coupés ou serrés, rendez un SVG et ouvrez-le dans un navigateur. Si le SVG est correct, le problème vient de la taille de page ou de l’échelle ; s’il est faux lui aussi, raccourcissez les libellés ou changez d’orientation (graph TD au lieu de graph LR).
Cadre blanc derrière le diagramme : utilisez un fond transparent. -b définit l’arrière-plan pour le PNG et le SVG (pas pour le PDF). La valeur par défaut est le blanc.
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
Mauvaise police ou mauvais thème : placez-les dans un fichier de configuration. -c charge une configuration JSON pour Mermaid, de sorte que tous les diagrammes exportés partagent la même police et le même thème. -t choisit un thème intégré (default, forest, dark, neutral) pour une seule exécution.
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
Les thèmes de l’éditeur ne suivent pas. Un thème sombre de VS Code, le mode sombre d’Obsidian ou un thème choisi dans l’interface d’un éditeur ne change que l’apparence de l’aperçu. Le fichier exporté utilise le thème écrit dans le diagramme (ligne init ou en-tête YAML) ou transmis à mmdc. Si l’export diffère de l’aperçu, écrivez le thème dans le diagramme.
mmdc refuse de s’installer : lancez-le avec npx. Les installations globales échouent sur les machines verrouillées. npx télécharge la CLI dans un cache et l’exécute une fois, sans installation globale. La première exécution télécharge aussi un navigateur sans interface, ce qui prend quelques minutes.
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

Exemples de frise chronologique et de diagramme de séquence

Ces exemples minimaux s’exportent avec les mêmes commandes. Enregistrez chacun dans un fichier .mmd.
Exemple de frise chronologique Mermaid (image/PNG) :
timeline
    title Research project timeline
    2024 : Grant awarded
    2025 : Pilot study : Data collection
    2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3
Exemple de diagramme de séquence Mermaid :
sequenceDiagram
    participant R as Researcher
    participant S as Sequencing core
    participant P as Analysis pipeline
    R->>S: Submit samples
    S-->>R: Raw reads
    R->>P: Run QC and alignment
    P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg

Les autres méthodes d’export

Mermaid Live Editor. Cet éditeur dans le navigateur exporte directement en SVG et en PNG depuis son panneau Actions ; c’est l’option la plus rapide pour un diagramme ponctuel. Il faut toutefois coller le diagramme dans un service hébergé : pour des informations sensibles, utilisez la ligne de commande en local.
Convertisseur Mermaid en PNG de SciFig. Collez votre code Mermaid dans le convertisseur Mermaid en PNG, lancez l’aperçu, puis téléchargez le PNG ou le SVG. Pour un PNG plus net, choisissez une échelle plus élevée entre 1× et 4× ; pour une diapositive à fond coloré, choisissez un fond transparent. Si le code contient une erreur de syntaxe, l’outil indique où elle se trouve au lieu d’exporter une image défectueuse : corrigez la ligne et relancez le rendu.
VS Code. Les extensions de prévisualisation Mermaid affichent les diagrammes pendant la rédaction. Leurs possibilités d’export varient ; la ligne de commande présentée plus haut permet de choisir explicitement une sortie SVG, PNG ou PDF.
Pipelines d’intégration continue. La commande mmdc permet d’intégrer le rendu des diagrammes à la compilation de la documentation. Une méthode courante consiste à versionner les sources .mmd et à produire les images à chaque compilation : le rendu reste ainsi à jour avec le code source.
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Pipeline d’intégration continue : sources Mermaid versionnées, images produites avec la documentation (figure générée avec SciFig)
Pipeline d’intégration continue : sources Mermaid versionnées, images produites avec la documentation (figure générée avec SciFig)

Exporter depuis Obsidian, VS Code et vers des articles ou des diapositives

Obsidian. Obsidian rend les blocs de code mermaid dans l’aperçu de la note, mais ne propose aucun bouton intégré pour enregistrer un diagramme seul en image. L’export de la note en PDF emporte le diagramme. Pour obtenir un PNG ou un SVG autonome, copiez le bloc de code dans Mermaid Live Editor, ou enregistrez-le dans un fichier .mmd et lancez mmdc. Comme mmdc lit le Markdown, vous pouvez aussi lui donner directement la note.
VS Code et aperçus Markdown. Une extension d’aperçu Mermaid affiche le diagramme au fil de la saisie. Pour exporter en PNG un diagramme Mermaid contenu dans du Markdown sous VS Code, utilisez une extension capable d’exporter, ou gardez le diagramme dans un fichier .mmd à côté de votre Markdown et rendez-le avec mmdc depuis le terminal intégré.
Articles et diapositives. Exportez en SVG (ou en PDF pour LaTeX), pas en PNG. Dans PowerPoint, insérez le SVG comme image ; les versions récentes peuvent le convertir en formes pour recolorer les blocs. Dans Illustrator ou Inkscape, ouvrez le SVG pour ajuster espacements, polices et pointes de flèches avant de le placer dans le manuscrit. N’utilisez un PNG à -s 3 ou plus que si un système de soumission refuse les fichiers vectoriels.
Même logigramme Mermaid avec les thèmes par défaut et neutre, pour comparer la lisibilité à l’impression (figure générée avec SciFig)
Même logigramme Mermaid avec les thèmes par défaut et neutre, pour comparer la lisibilité à l’impression (figure générée avec SciFig)

Régler l’apparence du diagramme

Les réglages par défaut de Mermaid répondent aux besoins de la documentation. Pour préparer une figure destinée à la publication, trois paramètres comptent particulièrement :

  • Thème. Placez theme: neutral sous config dans le bloc YAML en tête du diagramme. Examinez le rendu à sa taille finale avant de retenir un thème pour l’impression.
  • Police. Définissez fontFamily dans la configuration et assurez-vous que la police choisie est disponible dans l’environnement de rendu.
  • Orientation. Le choix entre graph LR et graph TD modifie les proportions du diagramme. Ce paramètre devient décisif lorsqu’il faut faire tenir la figure dans une colonne.

Un logigramme de processus de recherche avec un thème neutre et une police adaptée à l’impression :

---
config:
  theme: neutral
  fontFamily: Helvetica
---
graph LR
  A[Sample collection] --> B[Extraction]
  B --> C[Sequencing]
  C --> D[Analysis]

Quand choisir un autre outil que Mermaid

Mermaid calcule automatiquement la disposition des éléments, avec peu de possibilités d’intervention. Cette automatisation facilite la documentation, mais peut limiter les figures scientifiques dont la composition contribue au sens.

Mermaid convientPassez à SciFig FlowChart ou à un éditeur vectoriel
Documentation suivie dans un système de gestion de versionsFigure d’article qui doit respecter les conventions graphiques d’une revue
Diagrammes régénérés à chaque compilationDisposition précise, contrôlée bloc par bloc
La disposition automatique suffitPositions qui reflètent des relations réelles, comme un emplacement anatomique ou une succession temporelle
Source purement textuelle, lisible dans un diff de revueCo-auteurs qui modifient la figure visuellement plutôt que dans le code

Un compromis consiste à créer la structure dans Mermaid, à l’exporter en SVG, puis à terminer les retouches dans un éditeur vectoriel. Il faut alors accepter qu’une nouvelle génération depuis le code source ne reproduise pas ces retouches.

Disposition automatique de Mermaid et réorganisation manuelle du même contenu pour un article (figure générée avec SciFig)
Disposition automatique de Mermaid et réorganisation manuelle du même contenu pour un article (figure générée avec SciFig)
Autre voie : faire redessiner le diagramme dans SciFig FlowChart. Décrivez le diagramme en langage courant, ou joignez votre texte Mermaid en fichier .md, et le générateur de diagrammes à partir de texte fait dessiner par l’IA une version modifiable en SVG natif, où chaque bloc, libellé et flèche se déplace et se restyle directement. Pour une interaction comme l’exemple de séquence ci-dessus, le générateur de diagrammes de séquence fait de même pour les participants et les messages. Le service est gratuit pour commencer avec 150 crédits le premier jour, et l’édition, l’enregistrement et l’export SVG, PNG ou PPTX sont gratuits. Si vous comparez des outils de design à base de modèles pour le même usage, consultez nos alternatives à Canva pour les diagrammes.

Conseil

Versionnez le fichier source .mmd avec l’image exportée. Le texte permet de comprendre les changements lors d’une revue et de régénérer le diagramme ; l’image permet de consulter directement le résultat. Garder les deux facilite à la fois la relecture et l’utilisation.

Créez des figures scientifiques maintenant

Décrivez votre figure scientifique en langage naturel — obtenez des illustrations prêtes à publier en quelques minutes.

Essayer gratuitement
Pour les figures de publication au-delà des diagrammes, l’outil de création de figures à partir de texte de SciFig prend en charge les illustrations. Notre guide de visualisation de la recherche présente l’ensemble de cette démarche.

Pour aller plus loin

Lectures associées: Recherche visualisée instantanément par IA, 10 meilleurs outils d'illustration scientifique en 2026, 7 alternatives gratuites à Canva pour schémas (2026).

Questions fréquentes

Pour continuer

Ressources recommandées

Modèles, outils et lectures complémentaires pour vos recherches

Arrière-plan d'appel à l'action

Prêt à commencer ?

Des figures scientifiques prêtes à publier, en quelques minutes

Commencer gratuitement

Gratuit pour commencer · Pas de carte de crédit requise · Conçu pour les chercheurs