À propos
Construction du site (et du manuel)
Pour le site qui a précédé ce manuel, toutes les pages ont été rédigées en Markdown et mises en ligne grâce à MKDocs[1], logiciel permettant de créer de façon simple et rapide des sites Web statiques[2].
Pour la version « manuel », c’est la plateforme e-publish[3] qui a été utilisée par importation de la version ePub du site web.
Réflexions et chemin personnel
Ce manuel est entièrement consacré à l’utilisation de Markdown pour la rédaction et la production de documents académiques de qualité.
Habitué à la rédaction structurée depuis plus de 15 ans (plusieurs documents rédigés au format XML-Docbook avec oXygen), la découverte de Markdown est plus récente et date de fin 2017. Lors de la recherche d’un outil “distraction free” pour rédiger un article, Typora est apparu comme une évidence. Le format d’enregistrement des fichiers de Typora est Markdown et donc Markdown est également apparu comme une évidence.
Après avoir rédigé un premier billet sur infolit.be, deux petits tutoriels (Créer des documents professionnels avec Markdown et Pandoc. L’écriture numérique ouverte[4] et Créer des présentations avec Markdown, Beamer et Pandoc[5]) ont rapidement suivi.
Étant donné qu’il n’est pas simple de trouver une source francophone complète à propos de Markdown, il semblait nécessaire de proposer ce site Web, à la fois plaidoyer et petit manuel à l’usage des débutants pour découvrir, comprendre et utiliser Markdown. L’ensemble des contenus est basé sur ma propre expérience et sur les diverses découvertes, alimentées par mes besoins de trouver des solutions pragmatiques, à propos de Markdown.
Je ne suis pas un geek et les limites de mon utilisation de Markdown sont basées sur le niveau de complexité. Il est possible d’aller très loin avec des commandes et options moins accessibles. Le principe de base de cette présentation est que l’utilisation de Markdown pour la création de documents professionnels reste simple.
