Exporter du markdown avec pandoc

L'utilitaire pandoc et son utilisation pour le format markdown.

Pandoc est un utilitaire de conversion de fichier texte. Il peut virtuellement transformer tout format texte en un autre (voir les démos pour différentes conversions).

Nous allons ici juste montrer ses capacités pour le markdown.

Installation

D'après la doc, selon le système d'exploitation :

Selon le format d'export, il vous faudra d'autres logiciels. Je vous conseille d'ores et déjà d'installer latex pour pouvoir facilement exporter en pdf sans passer par html et un navigateur.

exemple d'utilisation

Pour exporter du markdown en html, j'utilise la ligne de commande suivante qui m'écrit de jolies équations avec https://www.mathjax.org/ :

pandoc --mathjax --standalone --metadata pagetitle="titre page" --metadata charset="UTF-8" page.md -o page.html

• premier élément : le nom de la commande, ici pandoc.
• cette commande prend en entrée le fichier page.md qui est le dernier élément de la ligne
• les autres éléments de la lignes sont des arguments. Dans le monde des commandes, il y a deux types de paramètres "un - suivit d'une lettre" et "deux -- suivi d'un mot" Ces paramètre peuvent être suivi d'arguments, c'est à dire des mots ne commençant pas par un - (-o page.html), ou pas (--mathjax) Notre commande a 4 paramètres :
  • -o page.html. Un paramètre avec un argument. Le fichier se sorti s'appellera page.html. Il determine le type de sortie (ici de l'html) et sera dans le même dossier que le fichier page.md
  • --mathjax. Un paramètre sans argument. On utilise la bibliothèque mathjax pour compiler les équations latex
  • --standalone. Un paramètre sans argument. On crée un fichier html complet (par défaut, pandoc ne crée qu'un bout de html qui peut être combiner avec d'autres bout)
  • --metadata pagetitle="titre page". Un paramètre avec un argument. En combinaison avec le paramètre standalone. Permet de donner un titre à la page html, ici "titre page".
  • --metadata charset="UTF-8". Un paramètre avec un argument. Permet de spécifier l'encodage des caractères (voir cours sur les fichiers). Devrait permettre de voir les accents.

Lorsque je fais mes tests en html, après chaque re-compilation je recharge la page avec "F5" ou "ctrl+R" dans le navigateur. Le process est très rapide.