Générer des présentations (slides) avec markdown
01/11/14
La syntaxe markdown permet à partir d'une syntaxe minimale de créer des pages html. Cependant ce format très apprécié car très clair et très simple ne se limite pas au web : on peut aussi créer des slides avec celui-ci.
Syntaxe
Un exemple vaut mieux qu'un long discours :
% Présentation d'exemple
% Donald Duck
% Le 2 mai 2134
# Planning de la journée
# Le matin
## Le réveil
- Éteindre l'alarme
- Sortir du lit
## Petit déjeuner
À faire dans l'ordre suivant :
- Servir le café
- Découper une part de brioche
- Manger la brioche
- Boire le café
# L'après midi
## Faire la sieste
Ne pas oublier votre hamac

---
Sur cette nouvelle diapo, il y aura une image de cocktaïl

Ne pas oublier une boisson dans le hamac.
Première solution : pandoc
Pandoc permet de générer des slides à partir de la syntaxe markdown très simplement. En fait, il va convertir le fichier texte en pdf avec en fait l'extension beamer de LaTeX.
La syntaxe est la suivante :
pandoc --slide-level 2 -i -t beamer -V theme:Darmstadt -s slide.md -o slide.pdf"
Quelques explications :
-s slide.md
: c'est notre fichier en markdown-o slide.pdf
: c'est notre présentation en pdf-V theme:Darmstadt
: on choisit le thème Darmstadt de beamer-t beamer
: on précise le format de sortie à utiliser-i
: fait en sorte que les lignes des listes apparaissent les unes après les autres, pas toutes en même temps.slide-level 2
permet de dire à pandoc à quel moment il considère une section comme une diapo.
Quoi qu'il en soit, man pandoc
vous en dira plus.
Sachez que vous pouvez aussi générer des présentations de type s5, ou avec
reveal.js afin de les lire dans un navigateur. Il faut remplacer -t beamer
par -t s5
pour s5 par exemple, et bien sûr ça ne devra pas produire
slide.pdf
mais slide.html
.
Astuce avec vim
Dans le fichier ~/.vimrc, ajoutez cette ligne afin de générer le pdf et le voir avec le programme mupdf en tapant successivement sur “2” et “s”.
" Slides Markdown
au BufNewFile,BufRead *.md map 2b :w<CR>:!pandoc --slide-level 2 -i -t beamer -V theme:Darmstadt -s "%" -o "%:p:r.pdf" > /tmp/pandocconvert.log; mupdf "%:p:r.pdf"<CR>
Images trop grandes
Si vos images sont trop larges et sont partiellement cachées, vous pouvez les redimensionner. Cela dit cela peut venir du fait qu'il manque des informations dans l'image. Donc avant de les redimensionner, utilisez-donc la commande suivante (paquet imagemagick nécessaire)
mogrify -density 96 -units PixelsPerInch image.png
Deuxième solution
… pas encore