Markdown en PDF sur Mac, en ligne de commande.

L’outil gratuit marsdawn transforme un fichier Markdown en PDF en une seule commande. Les tableaux, les formules, les diagrammes Mermaid et le code coloré sortent tels qu’on les lit dans la source, et rien d’autre n’est nécessaire, pas même l’app MarsDawn.

L’installer

brew install redtear1115/tap/marsdawn
marsdawn --version

Sur un Mac à puce Apple, Homebrew installe une copie précompilée en quelques secondes. Sur un Mac Intel, il compile à partir des sources, ce qui prend quelques minutes et nécessite Xcode 26 ou version ultérieure. L’outil fonctionne sous macOS 15 ou version ultérieure, et marsdawn --version affiche la version installée.

Enregistrer un document

Collez ceci dans un fichier nommé plan.md :

# Plan : des exports plus rapides

Un agent a rédigé ce plan. Vous le relisez, puis vous le transformez en PDF.

## Étapes

| Étape | Responsable | État |
|-------|-------------|------|
| Mesurer les pages lentes | Agent | Fait |
| Mettre en cache les diagrammes rendus | Agent | En relecture |

L'objectif est $t < 2\,\text{s}$ pour un document de 50 pages :

$$
t_{\text{total}} = \sum_{i=1}^{n} t_i
$$

```mermaid
graph LR
  Brouillon --> Relecture --> Publication
```

```swift
let pdf = try export("plan.md")
```

L’exporter

marsdawn export plan.md

Il écrit plan.pdf à côté de la source et indique où il l’a placé :

Exported /Users/you/plan.pdf (1 page)

Voici cette page, capturée lors d’une véritable exécution de marsdawn 0.5.0 :

Le PDF exporté : le titre, un tableau d’étapes, une formule dans le texte et une formule centrée, un diagramme Brouillon, Relecture, Publication et une ligne de Swift colorée.

Choisir un thème, un format de papier et un nom de fichier

marsdawn export plan.md --theme classic --paper letter -o handout.pdf

--theme : dawn, classic, modern ou vivid, dans les couleurs claires du thème. Sans cette option, export utilise $MARSDAWN_THEME, sinon dawn.
--paper : a4 ou letter. La valeur par défaut est a4.
-o : où écrire le PDF, au lieu de le placer à côté de la source.
--allow-remote-images : charge les images du web pendant le rendu. Elles restent désactivées si vous ne le précisez pas.

Si ça ne fonctionne pas

A full installation of Xcode.app 26.0 is required to compile this software. Homebrew compile marsdawn à partir des sources, comme sur un Mac Intel. Installez Xcode 26 ou version ultérieure depuis l’App Store, puis relancez l’installation.
marsdawn: No such file: … Le chemin ne mène pas à un fichier. Vérifiez le nom, ou lancez la commande depuis le dossier qui contient le fichier.
… already exists. Pass --force to replace it. Un PDF portant ce nom existe déjà. Ajoutez --force pour le remplacer, ou -o pour l’écrire ailleurs.
Error: The value '…' is invalid for '--theme <theme>'. Le thème ou le format de papier n’est pas reconnu. Les thèmes sont dawn, classic, modern et vivid ; le papier est a4 ou letter.

Pour aller plus loin

Toutes les options et le JSON produit : Ligne de commande.
Pour qu’un agent de code le fasse à votre place, exécutez marsdawn skill --install pour ajouter la skill d’agent marsdawn.
Les quatre thèmes d’aperçu, et la direction que prend l’export PDF : thèmes d’aperçu et export PDF.
Remettre le PDF à quelqu’un qui n’utilise pas Markdown : partager un PDF.