• Marp
  • Instalation du programme en ligne de commande (marp-cli)
    • macOS
    • Windows
    • Debian/Ubuntu
      • Installation via les binaires
      • Installation via node et npm
  • Afficher la liste des options
  • Watch (hot reload)
  • Conversions
    • Au format PDF
    • Au format HTML
    • Au format PPTX (powerpoint) lecture seule
    • Au format PPTX (powerpoint) éditable
  • Conversion avec inclusion de fichiers multimédias
    • Vers d'autres formats (XML, LaTeX, etc.)
  • Création d'un thème
  • Workflow
  • Autoriser le markup HTML dans les slides
  • Points à eclaircir
  • Ressources

Toutes les possibilités d'installation de l'application sont listées sur le dépôt.

Installer marp via le gestionnaire de paquets Homebrew

brew install marp-cli

Installer marp via le gestionnaire de paquets Scoop

scoop install marp

Télécharger l'archive contenant les binaires depuis son dépôt GitHub.

Extraire l'archive

tar xvzf marp-cli-v{derniere version}-linux-tar.gz

Copiez l'éxecutable présent dans l'archive dans un répertoire présent sur le PATH, par exemple

sudo cp marp /usr/local/bin

Vérifier que marp est bien installé

marp -h

Installer node et [npm](le gestionnaire de paquets de node), puis installer marp-cli globalement (option -g)

sudo apt-get update
sudo apt-get install nodejs npm
npm install -g @marp-team/marp-cli

Consulter la liste des options offertes par marp

marp -h

Il est possible de mettre toutes les options dans un fichier de configuration marp.conf, puis de le charger

marp -c marp.conf slide-deck.md

On peut également observer notre fichier de présentation markdown avec l'option -w

marp -w slide-deck.md

Marp convertira uniquement le fichier indiqué lorsqu'il observera des modifications (ici en HTML par défaut). On peut donc ouvrir la présentation HTML générée dans notre navigateur pour avoir une preview optimisée avec un hot reload.

Utilise Chrome ou Chromium

marp --pdf slide-deck.md

marp slide-deck.md

La conversion opère juste une conversion en images au format .pptx. Le document peut être ouvert dans powerpoint mais non éditable

marp --pptx slide-deck.md

Pour convertir la présentation markdown en pptx éditable, on peut passer par le format PDF puis utiliser un outil comme PDF to Powerpoint Converter ou Adobe

Il faut forcer le html avec l'option --html. Pour des exports PDF ou pptx, il faut également autoriser les fichiers locaux avec l'option --allow-local-files. Par exemple,

marp --theme my-theme.css --pdf --allow-local-files slide-deck.md

ou

marp --theme my-theme.css --pptx --allow-local-files slide-deck.md

On ne peut pas inclure de vidéos dans un fichier PDF et donc dans un fichier pptx avec cette méthode. Il vaut mieux uploader la vidéo sur une plateforme, par exemple Youtube et mettre un lien vers la vidéo.

Pour cela on peut passer par la conversion HTML puis utiliser pandoc

On peut créer un thème dédié au projet directement en CSS my-theme.css et l'utiliser avec l'option -theme

marp --theme my-theme.css slide-deck.md

Watch les sources markdown avec un thème custom

marp --theme my-theme.css -w slide-deck.md

Exporter vers des images dans un fichier powerpoint

marp --theme my-theme.css --pptx slide-deck.md

Les notes seront affichées pour la personne qui fait la présentation.

Utiliser l'option --html

marp --html --theme my-theme.css -w slide-deck.md

• La directive _class
• import video et images

• Marp écosystème
• Marpit framework, sur quoi est basé marp
• Marpit API
• Doc officielle Marp CLI
• Produire un powerpoint editable dans le workflow de Marp, l'export vers pptx de marp ne cree pas une présentation éditable mais une version images. Pour produire un ppt éditable il faut passer par le format pdf avant
• Pandoc, un convertisseur de document universel et éprouvé
• Convertisseur pdf vers powerpoint, un outil de conversion en ligne gratuit permettant de convertir un fichier PDF vers un fichier pptx éditable