Il y a également Apostrophe^[4], logiciel réservé aux seuls linuxien. Il pousse aussi très loin le principe du distraction free puisqu’il propose un écran complètement vide.

Le blog Free Markdown editors de Fabrizio Musacchio^[5] propose une liste d’éditeurs Markdown libres et gratuits. Cette liste est régulièrement mise à jour.

Il est aussi possible d’utiliser Markdown en ligne et de visualiser le résultat de sa transformation (au minimum en html) avec HedgeDoc^[6], markup.rock^[7], FocusFox^[8], Dillinger^[9], Stack Edit^[10], Preview Markdown^[11], Markdit^[12], HackMD^[13] ou Stylo^[14], via le navigateur, sans installation (les deux derniers nécessitent néanmoins une inscription, gratuite).

Pandoc

Pandoc a été créé en 2006, et est toujours maintenu, par John MacFarlan^[15]. C’est un logiciel libre (publié sous licence GPL) considéré comme le couteau-suisse de l’édition. Il permet de passer facilement d’un format de fichier à un autre. Il existe plus de 40 formats gérés par Pandoc^[16].

Pandoc s’utilise en mode terminal (“Terminal” sur une machine Linux ou Mac. Pour Windows il faut entrer “cmd” dans la zone de recherche). Pour la création de fichier pdf, Pandoc utilise toute la puissance de LaTeX qui doit être installé en même temps que Pandoc.

La commande de base est la suivante :

Le “-o” doit précéder le nom du fichier destination. La destination peut aussi être un fichier .html, un fichier .epub voire .docx ou .odt (pour rappel Pandoc gère plus de 40 formats).

Il est possible d’utiliser plusieurs fichiers “sources” (parties, chapitres…) simultanément dans la commande. Ici, l’en-tête YAML se trouve dans le premier fichier, elle ne doit pas être répétée.

Si vous numérotez vos fichiers (pour qu’ils soient traités dans le bon ordre, 01yalm.md 02intro.md, 03chap1.md, 04chap2.md…), vous pouvez simplifier la commande :

Il n’est pas nécessaire de maîtriser le mode ligne pour effectuer cette manipulation. Pour que la commande fonctionne, il faut néanmoins préciser l’endroit où se trouve(nt) le(s) fichier(s) .md (en ajoutant l’arborescence : dir/dir/fichier.md) ou se placer dans le bon répertoire (avec la commande “cd” pour change directory).

Vous trouverez des exemples de commandes sur la page Demos^[17] de Pandoc ainsi qu’un lien pour tester la conversion via un site Web, sans installer Pandoc.

Les modèles

Il est possible d’utiliser des modèles (des templates^[18]) pour l’exportation. Dans le chapitre sources se trouve une liste de liens vers des templates LaTeX qui remplacent le template par défaut. Pour l’appeler, il faut ajouter le nom du modèle dans la ligne de commande.

Cette possibilité existe aussi pour les exportations .docx ou .odt. Après avoir créé un modèle (mise en page, styles, en-tête et pieds de page…) avec le traitement de texte, on fait appel à ce modèle dans la commande pandoc.

La transformation

Avec Typora, MarkText et plusieurs autres outils, il est possible d’exporter directement un fichier Markdown en fichier pdf. Ce fichier n’aura cependant pas une forme comparable à un fichier pdf produit via LaTeX (mise en page stricte et professionnelle avec utilisation des données YAML, numérotation des pages, notes de bas de page, équations mathématiques, citations et bibliographie…). Les fichiers pdf créés sont en fait transformés en fichiers pdf en passant par le format html.

Néanmoins, quelques logiciels (par exemple Zettlr ou Apostrophe) vont utiliser directement Pandoc et LaTeX pour produire les documents pdf. Zettlr propose d’ailleurs des réglages très fins via la “gestion des assets” (commande Alt+Ctrl+,). Avec Apostrophe il y a par contre très peu d’options. Les réglages sont réalisés via l’en-tête YAML.

Il y a d’autres solutions. Par exemple, pour un document, édité dans Gedit (sous Linux), l’utilisation des “outils externes” permet d’appeler Pandoc sans sortir de l’éditeur.

Avec Stylo, la transformation (avec Pandoc et LaTeX) est intégrée dans les outils proposés.

L’association de Markdown et de Pandoc n’est pas limitée à de petits projets, un article ou un rapport mais peut aller jusqu’à la réalisation de projets plus ambitieux comme ce livre de 114 pages édité en Markdown et transformé avec Pandoc : Coulon, A., (2019). Ethnométhodologie et éducation^[19] . Ce livre produit par une “machine” n’a rien à envier aux ouvrages produits avec un logiciel de mise en page.