[Tuto] Faire du Latex en Markdown avec Pandoc

pandoc-markdown-latex-tuto

Je viens vous prĂ©senter aujourd’hui Pandoc, un logiciel permettant de crĂ©er des documents sans se soucier du style visuel en utilisant Markdown. Il m’arrive souvent de rĂ©diger des documents, mais qui dit rĂ©daction dit aussi logiciel de traitement de texte. Naturellement, nous pensons Ă  la suite office de Microsoft avec Word ou encore son alternative libre, LibreOffice – voire OpenOffice. Également rĂ©putĂ©, mais dans le domaine scientifique, Latex est principalement utilisĂ© pour la rĂ©daction de thèses ou de livres blancs. Pandoc lui est un convertisseur supportant de nombreux formats dont le rendu au travers de moteurs Latex.

Écrire des documents Latex en Markdown

DĂ©veloppĂ© par John Gruber en 2004, c’est un langage de balisage lĂ©ger dont la particularitĂ© est d’ĂŞtre facile Ă  lire et Ă  Ă©crire. Le Markdown a connu sa popularitĂ© grâce Ă  GitHub qui en a fait le langage de rĂ©fĂ©rence pour les documentations et son wiki.

Latex, le langage pour la rédaction de documents

Pour un nĂ©ophyte, Latex peut ĂŞtre difficile Ă  apprĂ©hender. Si bien qu’il nĂ©cessite plusieurs heures de prĂ©paration afin d’avoir des documents dignes de ce nom. Il permet surtout de s’affranchir de pas mal de problèmes tel que la mise en forme de ses titres, numĂ©rotation, etc. Des problèmes sur lesquels on pourrait passer plusieurs minutes – et mĂŞme heures – sur Word. Avantage Ă©galement Ă  Latex, celui-ci est pĂ©renne. Ce que l’on Ă©crit en Latex est stockĂ© sous forme de fichiers texte. Un document que vous auriez Ă©crit au dĂ©but de la dĂ©cennie serait encore lisible aujourd’hui. Pour information, Word utilise un format Ă  base de mĂ©tafichier – comparable Ă  un zip – et sauvegarde le tout avec du XML.

Une courbe d’apprentissage difficile

Apprendre Latex nĂ©cessite du temps et de l’attention. Ă€ mes dĂ©buts avec Latex, j’Ă©tais complètement perdu. DĂ©veloppĂ© pour des langues anglo-saxonnes, il me paraissait ridicule au dĂ©but de devoir ajouter des instructions afin d’utiliser des accents – jusqu’Ă  ce que je dĂ©couvre les paquets. Il me fallait chercher sur le web afin de connaitre les tags existants et leurs fonctions. Un processus long et fastidieux, qui une fois maĂ®trisĂ© et aidĂ© par un Ă©diteur (TexMaker, TexStudio, Visual Studio Code…) devient bien plus simple.

Utiliser Markdown pour remplacer Latex

Outre le fait d’ĂŞtre très populaire chez les programmeurs, Markdown commence Ă  se faire une rĂ©putation auprès des scientifiques. L’aspect simpliste de ce langage permet en effet de l’utiliser pour crĂ©er des documents PDF de qualitĂ© sans avoir Ă  connaitre Latex. Ă€ vous les joies du moteur d’Ă©quation de Latex avec les avantages du Markdown. Markdown est souple, simple et rapide. Un petit coup d’Ĺ“il sur la documentation permet de comprendre très simplement le fonctionnement du langage et de nombreux Ă©diteurs existent sur Internet. MĂŞme WordPress s’est mis au Markdown avec Jetpack et je m’y suis mĂŞme pris au jeu en rĂ©digeant quelques articles, de-ci de-lĂ . Travaillant le plus clair de mon temps sur Windows, je vous montre ici comment mettre en place une pile avec Latex et Pandoc.  Il est Ă  noter que les mĂŞmes manipulations sont Ă  effectuer si vous ĂŞtes Mac ou Linux.

Utiliser Pandoc et Miktex pour rédiger en Markdown

Installer Miktex

Avant de vous lancer dans la rĂ©daction de vos documents en Markdown vous aurez besoin de quelques logiciels. Tout d’abord comme compilateur Latex sur Windows, j’utilise Miktex, intègrant le nĂ©cessaire pour compiler des documents. Il est capable de rĂ©cupĂ©rer automatiquement des paquets et de les utiliser sans aucun problème sur un environnement Windows. Installez Miktex de la manière la plus simple que vous puissiez le faire. Un exĂ©cutable est disponible sur le site et l’installation se dĂ©rouler sans accrocs. TĂ©lĂ©charger Miktex

Installer Pandoc pour Markdown

Pandoc est un logiciel de conversion de documents. Il est capable de convertir de nombreux fichiers dans diffĂ©rents formats et est très utile pour ce que nous souhaitons faire. Pandoc peut par exemple convertir un document Latex en Word et inversement ou du Markdown en Latex. Vous pouvez bien sur retrouver l’ensemble des formats compatibles sur le site officiel. Pandoc dispose Ă©galement d’un exĂ©cutable Ă  installer, qu’il faut rĂ©cupĂ©rer sur GitHub. TĂ©lĂ©charger Pandoc

Utiliser un Ă©diteur de texte

J’utilise au choix Atom ou Visual Studio Code – mĂŞme quelque fois Sublime Text – pour mes rĂ©dactions en Markdown. Sur Atom, je vous conseille le paquet « Pandoc » et « Markdown Preview Plus ». Ils permettent mĂŞme l’affichage des Ă©quations dans la fenĂŞtre de prĂ©visualisation. Visual Studio Code dispose Ă©galement d’un plugin Pandoc, mais celui-ci est surtout destinĂ© Ă  la conversation.

Compilation

Lorsque votre document Markdown est prĂŞt, il vous suffit d’ouvrir une console dans le dossier oĂą il se situe.

pandoc NomDeMonDocument.md -o NomDeMonDocumentDeSortie.pdf

Patientez quelques secondes vous vous retrouverez avec un très beau document et formaté façon Latex.

Exemple

Afin vous aider encore un peu, je vous laisse un exemple que j’ai pu rĂ©diger en Markdown ici et dont le rendu PDF se retrouve sur le lien suivant : test-markdown-latex-pandoc-scientifique.

Kevin

Rédacteur professionnel schizophrénique sur la High-Tech et les jeux vidéo depuis sa chambre secrète rempli de serveurs et de routeurs.

Articles recommandés

3 commentaire

  1. […] permettant de crĂ©er du contenu texte en gardant quelque chose de lisible. Ă€ la diffĂ©rence de Latex par exemple, qui nĂ©cessite l’utilisation de commandes, Markdown utilise des marques. Il […]

  2. […] AbrĂ©gĂ© « PDF Â», le « Portable Document Format Â» a Ă©tĂ© dĂ©veloppĂ© en 1992 par Adobe et est ensuite devenu une norme en 1998. Le PDF permet de prĂ©server la mise en page (police, image, Ă©lĂ©ments graphiques, etc.) d’un document sur tous les systèmes d’exploitation, les logiciels de lecture ou l’ordinateur. Ainsi cela permet d’avoir un document qui sera semblable au document imprimĂ© quel que soit le terminal utilisĂ© pour la lecture. C’est d’ailleurs le format qui a Ă©tĂ© sĂ©lectionnĂ© pour la chaĂ®ne de compilation Latex. […]

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *