Présentation de Pandoc (1) : un filtre qui convertit par défaut du Markdown en HTML

Le programme pandoc convertit du texte d’un format à un autre : Markdown, Latex, HTML, EPUB, ODT, etc. On peut aussi l’utiliser pour créer des PDF.

C’est un filtre, comme le sont tr, cut ou sed : il lit du texte sur l’entrée standard, le transforme, l’envoie sur la sortie standard. Par défaut, il convertit du Markdown en HTML.

J’ouvre un terminal, entre le nom de la commande et appuie sur Entrée. Le curseur passe au début de la ligne suivante : pandoc attend que je saisisse quelque chose. Entrons donc ces lignes :

$ pandoc
Voici un poème très court de Guillaume Apollinaire, intitulé *Chantre* :

> Et l’unique cordeau des trompettes marines

Une fois cela fait, j’appuie Entrée pour revenir au début d’une ligne, puis sur Ctrl-D, ce qui signale la fin de ma saisie.

Pandoc affiche alors du code HTML correspondant au Markdown que je viens d’entrer :

<p>Voici un poème très court de Guillaume Apollinaire, intitulé
<em>Chantre</em> :</p>
<blockquote>
<p>Et l’unique cordeau des trompettes marines</p>
</blockquote>

Puisque Pandoc lit sur l’entrée standard, on peut utiliser les redirections du shell pour lui faire lire le contenu d’un fichier :

$ cat entrée.md 
a *b* **c**
$ pandoc < entrée.md
<p>a <em>b</em> <strong>c</strong></p>

De même, on peut rediriger vers un fichier la sortie qu’il produit :

$ pandoc > sortie.html
# Guerre et paix
$ cat sortie.html 
<h1 id="guerre-et-paix">Guerre et paix</h1>

Et les deux à la fois :

$ cat entrée.md 
C’est tout pour aujourd’hui.
$ pandoc < entrée.md > sortie.html
$ cat sortie.html 
<p>C’est tout pour aujourd’hui.</p>

Nous verrons dans une prochaine note qu’il existe d’autres manières, plus utiles pour nous, de lire et d’écrire des fichiers avec pandoc.