Ceci est une ancienne révision du document !
Les sources principales de documentation :
On peut utiliser le plugin vim-markdown (attention notamment à insérer let g:vim_markdown_folding_disabled=1
dans le .vimrc
pour éviter le repli).
Personnellement, je ne suis pas tout à fait satisfait de ce plugin, c'est peut-être aussi que je ne sais pas l'utiliser correctement, mais j'ai des auto-indentations étranges, qui n'impactent pas le rendu, mais me dérangent au niveau de la lecture de la source en .md
.
Ce qui fonctionne bien, c'est de faire en sorte que vim reconnaisse bien le filetype : :set filetype=markdown
ou carrément l'ajouter dans le .vimrc
:
au BufRead,BufNewFile *.md set filetype=markdown
Pour générer des PDF, il faut que LaTeX soit bien installé, avec les packages nécessaires, bien entendu.
La commande simple, à partir d'un fichier markdown :
pandoc -o output.pdf input.md
Par défaut, cette commande produit un document en format US/letter, en anglais. Il est bien entendu possible de configurer la sortie en A4, en français (pour autant que tous les packages soient installés, bien entendu again) :
pandoc --variable=papersize:a4paper --variable=lang:french -o output.pdf input.md
Comme on a bien structuré notre document, il est possible de créer une table of content : --toc
. Ce que je n'ai pas encore regardé, c'est comment numéroter les chapitres (avec un .odt
, il suffit d'utiliser un template dont la numérotation des chapitres est configurée…).