Outils pour utilisateurs

Outils du site


informatique:md-pandoc

Ceci est une ancienne révision du document !


Markdown et Pandoc

Documentation

But et intérêt

Installation

Utilisation avec vim

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

Commandes

PDF

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…).

Citations

informatique/md-pandoc.1422181017.txt.gz · Dernière modification: 2018/07/29 09:08 (modification externe)