Marp : l'outil de présentation en Markdown (et comment exporter vers PowerPoint)

Si vous avez cherché « marp » en vous attendant à un terme dentaire ou orthodontique, c'est l'autre : Marp est le Markdown Presentation Ecosystem – un projet open source (MIT) de l'équipe marp-team sur GitHub, qui permet de construire des diaporamas en écrivant du Markdown pur. Pas de boîtes à faire glisser sur un canevas, pas de format de fichier propriétaire. Vous écrivez # Slide title et quelques puces, ajoutez une directive ou deux, et Marp en fait une présentation. (Le « MARPE » sans rapport que vous avez peut-être vu est une procédure d'expansion maxillaire en orthodontie – rien à voir avec les diapositives. Cet article porte strictement sur Marp, l'outil de présentation.)

Marp est l'option la plus simple et la plus native au Markdown parmi les outils de présentation open source, et c'est précisément pourquoi les développeurs s'y tournent. Voici un guide honnête sur ce qu'est Marp, sur le fonctionnement de la rédaction et des thèmes, sur la façon dont la Marp CLI exporte vers PowerPoint et PDF (et le seul bémol qui prend les gens au dépourvu), sur sa comparaison avec reveal.js et Slidev, et sur l'endroit où un design workspace prend le relais quand le Markdown atteint ses limites.

Ce qu'est Marp

Marp est un petit écosystème d'outils bâti autour d'une seule idée : les diapositives en Markdown. Il comporte trois pièces mobiles. Marpit est le framework de bas niveau qui transforme du Markdown accompagné d'un thème en HTML et CSS de diapositives. Marp Core est le moteur clé en main posé sur Marpit, avec un thème par défaut, la gestion des images et la prise en charge des formules mathématiques. Marp CLI (marp-team/marp-cli) est l'outil en ligne de commande qui rend votre fichier Markdown en HTML, PDF ou PowerPoint. Il existe aussi une extension VS Code officielle qui vous offre un aperçu côte à côte en temps réel pendant que vous tapez.

Vous rédigez dans un seul fichier .md. Les diapositives sont séparées par ---, les réglages par diapositive et globaux se définissent via des directives Marp (comme theme:, paginate: ou class:), et tout reste du texte brut versionnable. C'est là tout l'attrait : votre diaporama se diffe proprement dans Git, vit à côté de votre code, et ne vous enferme jamais dans un format binaire.

Les thèmes Marp et la rédaction en Markdown

Rédiger un diaporama Marp est délibérément minimal. Un bloc de front-matter en haut du fichier définit les directives globales, --- sépare les diapositives, et le Markdown standard – titres, listes, blocs de code, images, tableaux – devient votre contenu. Comme Marp effectue en coulisses un rendu en HTML et CSS, tout ce que le Markdown exprime se traduit en une diapositive sans syntaxe supplémentaire à apprendre.

Les thèmes Marp ne sont que du CSS. Marp Core livre une poignée de thèmes intégrés (default, gaia, uncover), et vous passez de l'un à l'autre avec une seule directive theme:. Quand les thèmes intégrés ne suffisent plus, vous écrivez le vôtre sous forme de fichier CSS – ciblez les classes que Marpit expose, enregistrez-le auprès de la CLI via --theme ou --theme-set, et chaque diapositive l'adopte. Pour des ajustements en ligne, vous pouvez glisser un bloc <style> à portée limitée dans une seule diapositive. Ce modèle CSS-natif est à la fois le plafond et le plancher de Marp : si vous êtes à l'aise avec le CSS, vous avez un contrôle total, et sinon, les valeurs par défaut restent élégantes.

Exporter Marp vers PowerPoint et PDF

C'est à l'export que la Marp CLI justifie sa place. Pointez-la vers votre Markdown et choisissez une cible :

HTML – marp deck.md -o deck.html produit un diaporama web autonome que vous présentez dans le navigateur.
PDF – marp deck.md --pdf rend un PDF prêt à imprimer, idéal pour les documents à distribuer et le partage.
PowerPoint – marp deck.md --pptx exporte un fichier .pptx que vous pouvez ouvrir dans PowerPoint ou Keynote.

Le seul bémol qui mérite d'être dit clairement : l'export PPTX de Marp rend chaque diapositive sous forme d'image, et non de formes PowerPoint natives et modifiables. Chaque diapositive devient une image pleine page à l'intérieur de l'enveloppe .pptx. C'est parfait quand vous devez remettre un fichier à quelqu'un qui vit dans PowerPoint et n'a qu'à le présenter – mais une fois exporté, vous ne pouvez pas cliquer pour modifier une zone de texte, recolorer une forme ou déplacer une puce. Si votre flux de travail doit continuer à éditer dans PowerPoint ensuite, traitez le pptx de Marp comme un format de livraison, pas comme un format source. (Des modes d'export « modifiables » expérimentaux sont apparus puis ont disparu ; le comportement fiable et documenté est une image par diapositive.)

Marp vs Slidev vs reveal.js

Marp n'est pas le seul outil de présentation Markdown-first. Voici la comparaison honnête selon les axes qui décident de votre choix :

Outil	Rédaction	Export PPTX modifiable	Gabarits	Licence
Marp	Markdown pur + directives	pptx en images (pas de formes modifiables)	Thèmes CSS	MIT
reveal.js	HTML (plugin Markdown optionnel)	Pas de pptx natif	Thèmes HTML/CSS	MIT
Slidev	Markdown + composants Vue	Pas de pptx natif (PDF/PNG/SPA)	Thèmes Vue + Windi/UnoCSS	MIT
Open Design	Décrivez-le à votre agent	Diaporama modifiable adossé à un design system	Design system + bibliothèque de modèles	Apache-2.0

Marp est le choix quand vous voulez le moins de cérémonie – un seul fichier Markdown et une CLI. reveal.js est le framework de diapositives web mature : HTML-first, personnalisable à l'infini et offrant l'expérience la plus riche dans le navigateur, mais vous écrivez du HTML et il n'y a pas de voie PowerPoint native. Slidev se situe au milieu, pour les développeurs qui veulent du Markdown accompagné de vrais composants Vue, de la coloration syntaxique et des intégrations interactives – plus de puissance que Marp, mais plus de configuration aussi. Les trois sont sous licence MIT et n'exportent rien de directement modifiable dans PowerPoint.

La place d'Open Design

Marp excelle exactement en une chose : prendre le Markdown que vous avez déjà écrit et le transformer en diapositives. Mais il vous demande, à vous, d'écrire le diaporama – la structure, la formulation, le CSS du thème. Il ne génère pas le contenu, ne le maintient pas cohérent avec votre marque d'un projet à l'autre, et ne vous donne pas d'artéfact modifiable une fois l'export réalisé.

Open Design est la couche au-dessus. C'est un Agent-Native Design Workspace open source (Apache-2.0), local-first, avec vos propres clés, qui se situe en dehors de l'agent de code que vous utilisez déjà. Au lieu d'écrire du Markdown à la main, vous décrivez le diaporama voulu, et l'agent en génère un modifiable adossé à un design system – avec des modèles de diaporamas HTML propriétaires dans sa bibliothèque de plugins comme point de départ. Ce n'est pas un remplacement du Marp rédigé en Markdown : quand vous avez déjà le contenu en Markdown et voulez un diaporama rapide depuis la ligne de commande, Marp est le bon outil. Quand vous voulez que le diaporama soit généré, conforme à la marque et toujours modifiable au sein d'un flux de conception plus large, c'est le rôle du workspace. Si vous créez déjà des diapositives avec un agent de code, voyez comment un agent de code crée des diaporamas.

FAQ

Qu'est-ce que Marp ? Marp est le Markdown Presentation Ecosystem open source de l'équipe marp-team sur GitHub. Vous écrivez des diapositives en Markdown, et la Marp CLI les exporte en HTML, PDF ou PowerPoint. Il est sous licence MIT et inclut Marp Core, le framework Marpit et une extension VS Code. Il n'a aucun rapport avec le terme orthodontique « MARPE ».

Comment exporter un diaporama Marp vers PowerPoint ? Installez la Marp CLI (marp-cli) et lancez marp deck.md --pptx. Notez que le .pptx exporté rend chaque diapositive sous forme d'image, et non de formes PowerPoint natives et modifiables – parfait pour la remise, mais vous ne pourrez pas ensuite modifier le texte ou les formes dans PowerPoint.

Marp peut-il exporter des fichiers PowerPoint modifiables ? Pas de façon fiable. Le comportement PPTX documenté de Marp est une image par diapositive. Si vous avez besoin d'un .pptx nativement modifiable avec de vraies zones de texte et formes, Marp n'est pas le bon outil pour cette étape.

Marp est-il gratuit ? Oui. Marp est open source sous licence MIT, donc libre d'utilisation, auto-hébergeable et modifiable.

Marp vs reveal.js vs Slidev – lequel choisir ? Choisissez Marp pour les diaporamas en Markdown pur les plus simples et un export PDF/pptx facile, reveal.js pour un framework de diapositives web mature, HTML-first et profondément personnalisable, et Slidev pour du Markdown accompagné de composants Vue interactifs. Les trois sont sous licence MIT ; aucun n'exporte du PowerPoint directement modifiable.

À retenir

Marp est la manière la plus nette de transformer en diapositives le Markdown que vous avez déjà – un seul fichier .md, des thèmes CSS et une CLI qui exporte HTML, PDF et PowerPoint. Rappelez-vous simplement la seule limite honnête : le pptx sort sous forme d'images, alors traitez-le comme un format de livraison plutôt que comme quelque chose que vous continuerez à éditer dans PowerPoint. Si votre besoin est « j'ai le Markdown, donnez-moi un diaporama », Marp est difficile à battre. Quand le diaporama doit être généré, rester conforme à la marque et demeurer modifiable au sein d'un flux de conception plus vaste, c'est là qu'un Agent-Native Design Workspace prend le relais.