MDPress

Mermaid en PDF

Convertir un diagramme Mermaid en PDF, avec le Markdown autour

Écrivez votre diagramme de flux, de séquence ou de Gantt dans un bloc de code mermaid et MDPress le dessine. Le diagramme apparaît dans l’aperçu en direct et se retrouve dans le PDF en tant que dessin vectoriel, si bien que les lignes restent nettes à tout niveau de zoom. Sans installation, sans ligne de commande et sans compte pour vos quatre premiers PDF par jour.

Ouvrir le convertisseur

Du bloc mermaid au PDF en trois étapes

  1. 01

    Collez votre Markdown

    Collez le document dans l’éditeur, ou importez un fichier .md. Gardez chaque diagramme dans un bloc de code délimité par trois accents graves suivis du mot mermaid, comme GitHub l’attend.

  2. 02

    Vérifiez le diagramme dans l’aperçu

    L’aperçu dessine chaque diagramme au fil de la saisie. Si la syntaxe contient une erreur, le bloc s’affiche comme du code brut, ce qui vous permet de repérer la ligne fautive et de la corriger avant l’export.

  3. 03

    Choisissez un style et téléchargez

    Choisissez Épuré, Éditorial ou Technique, puis A4, A5 ou US Letter. Appuyez sur le bouton PDF et le fichier se télécharge avec vos diagrammes intégrés et le texte environnant sélectionnable.

Un fichier Markdown avec un diagramme de flux Mermaid

Cette courte note de procédure contient un diagramme de flux entre deux passages de Markdown classique.

# Processus de mise en production

Chaque changement suit le même chemin, de la revue à la production.

```mermaid
flowchart LR
  A[Ouvrir la pull request] --> B[Revue de code]
  B --> C[Lancer les tests]
  C --> D[Déployer en préproduction]
  D --> E[Mise en production]
```

## Notes

- Les revues nécessitent une approbation.
- Les tests s’exécutent à chaque envoi.
- La préproduction utilise les mêmes réglages que la production.

Processus de mise en production

Chaque changement suit le même chemin, de la revue à la production.

flowchart LR
  A[Ouvrir la pull request] --> B[Revue de code]
  B --> C[Lancer les tests]
  C --> D[Déployer en préproduction]
  D --> E[Mise en production]

Notes

  • Les revues nécessitent une approbation.
  • Les tests s’exécutent à chaque envoi.
  • La préproduction utilise les mêmes réglages que la production.

Pourquoi convertir vos diagrammes Mermaid ici

Du vectoriel, pas une capture d’écran

Chaque diagramme est intégré au PDF sous forme de dessin vectoriel plutôt que d’image matricielle. Zoomez sur un diagramme de flux dense ou imprimez-le sur papier, les lignes et les libellés restent nets.

Le diagramme et le document ensemble

La plupart des outils Mermaid exportent une image isolée. Ici, le diagramme s’intègre dans tout le document, à côté de vos titres, tableaux et code mis en valeur, si bien qu’une spécification ou une note de conception part en un seul fichier.

Des diagrammes qui restent d’un seul tenant

Un diagramme est réduit pour tenir dans la largeur de la page, et la mise en page évite de le couper sur deux pages. S’il tombe mal, placez une ligne \newpage au-dessus pour démarrer une nouvelle page.

Conseils pour des diagrammes propres

  • Gardez les libellés des nœuds courts et simples. Des libellés longs élargissent le diagramme, et un diagramme large est réduit pour tenir dans la page, ce qui rétrécit son texte.
  • Les grands diagrammes se lisent mieux en A4 ou US Letter qu’en A5. Pour une longue chaîne d’étapes, essayez un diagramme de flux de haut en bas afin d’utiliser la hauteur de la page.
  • Si un bloc s’affiche comme du code dans l’aperçu, la syntaxe Mermaid contient une erreur. Le PDF affichera le même bloc de code, donc corrigez-la avant de télécharger.

Questions sur Mermaid en PDF

Comment convertir un diagramme Mermaid en PDF ?
Placez le diagramme dans un bloc de code marqué mermaid, collez-le dans MDPress et appuyez sur le bouton PDF. Le diagramme peut être tout le document ou une seule partie d’un fichier Markdown plus long. Les deux fonctionnent de la même façon.
Quels types de diagrammes Mermaid sont pris en charge ?
MDPress exécute la bibliothèque Mermaid standard dans votre navigateur, si bien que les diagrammes de flux, de séquence, de classes, d’états, de Gantt et les autres types intégrés sont dessinés. Si un diagramme s’affiche dans l’aperçu, il sera dans le PDF.
Est-ce gratuit, et mon diagramme est-il conservé ?
Vous avez quatre PDF gratuits toutes les 24 heures sans compte et cinq avec un compte gratuit. Votre texte est envoyé une fois au serveur pour créer le PDF et n’est pas conservé. Le brouillon lui-même reste dans votre navigateur.

Transformez votre Markdown Mermaid en PDF

Collez un document avec un bloc mermaid et regardez le diagramme apparaître dans l’aperçu.

Ouvrir le convertisseur