Convertisseur en ligne gratuit de MERMAID en PDF

Le format PDF est utilisé lorsqu’un diagramme Mermaid doit être partagé avec des personnes qui ne disposent pas d’un éditeur Mermaid, imprimé ou conservé dans une mise en page fixe. La conversion du diagramme source en PDF restitue son organigramme ou sa carte heuristique sous forme de document portable, au lieu de le laisser sous forme de code de diagramme modifiable.

Qu’est-ce que le format MERMAID ?

Mermaid est un format de diagramme textuel utilisé pour les organigrammes, les cartes heuristiques, les diagrammes de séquence, les diagrammes entité-association, les frises chronologiques et les documents visuels associés. Les fichiers utilisent généralement .mmd ou .mermaid ; le code Mermaid peut également apparaître dans des blocs délimités de fichiers Markdown.

Un fichier Mermaid contient des instructions sources telles que des libellés de nœuds, des connexions, des déclarations de mise en page et des styles, plutôt qu’une image finalisée. Mermaid Live Editor, Mermaid CLI, les extensions Visual Studio Code, Obsidian et les systèmes de documentation Markdown peuvent créer ou restituer ces diagrammes.

Qu’est-ce que le format PDF ?

Le format PDF stocke le diagramme rendu avec les dimensions de page, les polices, les couleurs et les informations de mise en page. Il convient à l’impression, aux pièces jointes d’e-mails, à la documentation, aux rapports techniques et aux copies d’archivage, car les destinataires peuvent le consulter avec un logiciel PDF standard sans installer Mermaid.

Le format PDF est normalement un format de présentation, et non un format source : la modification du diagramme nécessite généralement de modifier le fichier Mermaid d’origine et d’exporter un nouveau PDF.

Comment convertir MERMAID en PDF

Avec Mermaid CLI

1. Installez Node.js s’il ne l’est pas déjà.
2. Installez Mermaid CLI avec npm install -g @mermaid-js/mermaid-cli.
3. Placez le code source du diagramme dans un fichier tel que flowchart.mmd. Vérifiez qu’il commence par une syntaxe Mermaid valide, par exemple flowchart TD.
4. Exécutez mmdc -i flowchart.mmd -o flowchart.pdf.
5. Ouvrez flowchart.pdf et vérifiez les libellés, les connecteurs, les sauts de page et le rendu des polices.

Pour qu’un diagramme tienne sur une seule page PDF, utilisez mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. La commande utilise le moteur de rendu basé sur Chromium de Mermaid : le PDF contient donc le diagramme rendu plutôt que le code source d’origine.

Avec 101convert.com

Vous pouvez convertir le fichier gratuitement sur 101convert.com sans installer de logiciel. Importez le fichier Mermaid, sélectionnez PDF comme format de sortie, lancez la conversion, puis téléchargez le document obtenu. Cette option est utile lorsque Node.js et Mermaid CLI ne sont pas disponibles.

Avec un éditeur Mermaid

Ouvrez le code source dans un éditeur prenant en charge le rendu Mermaid, puis utilisez Export → PDF ou Print → Save as PDF du navigateur. L’impression depuis le navigateur constitue une solution de secours : elle peut ajouter des marges, des en-têtes, des pieds de page ou une mise à l’échelle qui ne sont pas présents dans un export direct avec Mermaid CLI.

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

Les grands diagrammes peuvent être réduits jusqu’à rendre les libellés difficiles à lire. Divisez un code source chargé en plusieurs diagrammes, augmentez les dimensions de la page via la configuration de Mermaid CLI ou exportez des PDF distincts pour les différentes sections.

La sortie PDF dépend de la version de Mermaid, du thème de rendu, des polices installées et des icônes ou ressources externes référencées. Utilisez la même version de Mermaid CLI pour obtenir des exports reproductibles et choisissez une police courante ou incorporez les polices requises via la configuration du moteur de rendu lorsque le PDF doit être ouvert sur d’autres systèmes.

Les fonctionnalités interactives, la possibilité de modifier le code source et certains styles propres au navigateur ne sont pas conservés dans le PDF. Conservez le fichier .mmd d’origine avec le PDF lorsque des modifications ultérieures sont probables.