{"id":8320,"date":"2018-11-24T10:10:44","date_gmt":"2018-11-24T08:10:44","guid":{"rendered":"https:\/\/tangi-bertin.net\/blog\/?p=8320"},"modified":"2018-11-24T20:34:35","modified_gmt":"2018-11-24T18:34:35","slug":"le-markdown","status":"publish","type":"post","link":"https:\/\/tangi-bertin.net\/blog\/le-markdown-8320\/","title":{"rendered":"Pourquoi j’\u00e9cris en Markdown"},"content":{"rendered":"

Mais c’est quoi Markdown ?<\/h2>\n

\u00abA Markdown-formatted document should be publishable as-is, as plain text, without looking like it\u2019s been marked up with tags or formatting instructions.\u00bb (John Gruber<\/a>)<\/p><\/blockquote>\n

Le Markdown est un langage de balisage l\u00e9ger. Imagin\u00e9 au d\u00e9but des ann\u00e9es 2000 pour distinguer la structure s\u00e9mantique (titres, sous-titres, paragraphes, …) et la mise en forme d\u2019un document, MD (pour les intimes) permet de produire des contenus \u00e9ditoriaux dont le code est facilement compr\u00e9hensible par un humain[1]<\/a><\/sup>.<\/p>\n

Inspir\u00e9 par la structuration des emails en \u00ab\u00a0texte plein\u00a0\u00bb, Markdown est un langage facile \u00e0 lire, sans tags \u00e9tranges ni balises originales.<\/p>\n

De plus, et cela sera un point important pour la suite, MD est facilement convertible en XHTML (ou HTML)[2]<\/a><\/sup>.<\/p>\n

Markdown, vous l’avez probablement d\u00e9j\u00e0 rencontr\u00e9 sans le savoir, m\u00eame dans des applications \u00e0 grand succ\u00e8s comme WhatsApp et Hangout ou encore dans les commentaires YouTube.<\/p>\n

Pourquoi j’utilise Markdown ?<\/h2>\n

Le positionnement<\/h3>\n

Dans une optique de lib\u00e9ration des individus des technologies qu’ils utilisent, et en vue d’am\u00e9liorer leur compr\u00e9hension de ces m\u00eames outils, indispensables \u00e0 une vraie lib\u00e9ration, MD semble \u00eatre un point d’entr\u00e9e int\u00e9ressant.<\/p>\n

La dynamique de travail collaboratif que j’ai rencontr\u00e9 dans Cit\u00e9 Libre<\/a><\/strong> a amen\u00e9 la recherche d’outils et de formats de fichiers pour que les membres de l’\u00e9quipe puissent produire du contenu ensemble. Articul\u00e9 autour d’un d\u00e9p\u00f4t Git, notre workflow (imagin\u00e9 par Pierre<\/a>) s’est naturellement orient\u00e9 vers Markdown, \u00e0 la fa\u00e7on de tr\u00e8s nombreux d\u00e9veloppeurs qui optent pour ce langage afin de publier leur documentation. Cette derni\u00e8re est ainsi facilement lisible et accessible au travers d’un rendu interpr\u00e9t\u00e9 en html.<\/p>\n

Les technologies ne doivent pas \u00eatre des bo\u00eetes noires magiques mais des outils dont nous percevons, \u00e0 minima, le fonctionnement, et dont les algorithmes mis en \u0153uvre sont accessibles \u00e0 tous.<\/p>\n

La notion d\u2019appropriation se r\u00e9v\u00e8le probl\u00e9matique en ce qui concerne les logiciels, surtout lorsqu\u2019ils sont dits propri\u00e9taires, c\u2019est-\u00e0-dire lorsqu\u2019ils nous privent de cette capacit\u00e9. Notre usage quotidien des traitements de texte, dont nous avons appris \u00e0 tirer le meilleur avec le temps, conduit \u00e0 nous les rendre familiers, de telle sorte que nous pensons nous les \u00eatre appropri\u00e9s (JULIEN DEHUT, 2018)[3]<\/a><\/sup><\/p><\/blockquote>\n

Les mauvaises habitudes li\u00e9es aux outils de traitement de texte<\/h3>\n

<\/p>\n

Dans son excellent article Markdown comme condition d’une norme de l’\u00e9criture num\u00e9rique<\/em>[4]<\/a><\/sup> Antoine Fauchi\u00e9<\/strong> fait un panorama de la situation actuelle dont l’un des mots majeurs, selon lui est le WYSIWYG (What You See Is What You Get<\/em>, ou ce que vous voyez est ce que vous obtenez<\/em> en fran\u00e7ais).
\nL’av\u00e8nement du WYSIWYG s’est fait \u00e0 une \u00e9poque o\u00f9 l’essentiel de la documentation produite au travers de l’ordinateur avait une seule finalit\u00e9 : \u00eatre imprim\u00e9e sur papier. La force du dispositif est d’avoir une impression aussi fid\u00e8le que ce que l’utilisateur voit \u00e0 l’\u00e9cran. Cependant, avec les ann\u00e9es, ce paradigme, avec la migration des habitudes de lecture vers l’\u00e9cran au d\u00e9triment de l’imprim\u00e9 et \u00e0 la multiplication des devices, est devenu caduc.<\/p>\n

le mode WYSIWYG suppose que la fa\u00e7on dont nous mettons en forme un document devra \u00eatre similaire partout, sans accepter qu\u2019il puisse y avoir des diff\u00e9rences : par exemple entre deux navigateurs web ; ou, dans le cas du livre num\u00e9rique, entre deux dispositifs ou applications de lecture16 ; ou encore, dans le temps, en fonction des \u00e9volutions des standards ou des moteurs de rendu. (JULIEN DEHUT, 2018)<\/p><\/blockquote>\n

Les documents produits par les traitements de texte se r\u00e9v\u00e8lent fondamentalement inadapt\u00e9s \u00e0 cet horizon de la consultation qui n\u2019est plus l\u2019imprimerie, mais l\u2019ordinateur. En la mati\u00e8re, un logiciel \u00e9crase la concurrence depuis des ann\u00e9es : Microsoft Word[5]<\/a><\/sup>. Comme ses camarades du secteur (Page, libre office, …) en plus de ne pas avoir abandonn\u00e9 le cadre rassurant de la page A4, et malgr\u00e9 l’apparente facilit\u00e9 induite par l’interface, la s\u00e9mantique est un \u00e9l\u00e9ment peu valoris\u00e9 et souvent oubli\u00e9. Mais \u00ab\u00a0un texte en gras et en corps 24 ne sera pas un titre de niveau 2, \u00e0 moins de qualifier ce texte s\u00e9mantiquement<\/em>\u00ab\u00a0[4:1]<\/a><\/sup>. R\u00e9sultat : un document lisible et compr\u00e9hensible par l’humain, un contenu sans sens pour la machine.<\/p>\n

Dans un univers plus proche de nous, l\u2019\u00e9diteur visuel pour HTML (cms, ide,…), et ce, malgr\u00e9 de grand progr\u00e8s ces derni\u00e8res ann\u00e9es dans la qualit\u00e9 du code produit, apporte encore trop souvent la confusion entre forme \/ s\u00e9mantique. Pourtant, nous savons \u00e0 quel point elle est importante pour tous les p\u00e9riph\u00e9riques d’affiches, pour les syst\u00e8mes d’aide aux d\u00e9ficients visuels et auditifs, ainsi qu’\u00e0 nos moteurs de recherche pr\u00e9f\u00e9r\u00e9s.<\/p>\n

Sans Web s\u00e9mantique, sans cette lisibilit\u00e9 fondamentale, Google, en tant que moteur de recherche serait aveugle, puisque pour \u00eatre index\u00e9es, utilis\u00e9es, diffus\u00e9es, les donn\u00e9es doivent \u00eatre lisibles. Or, non seulement enregistrer un texte sous le format docx ne le rend pas lisible pour des yeux humains, pas plus que le format doc, ou le format odt ; mais plus encore, l\u2019enregistrement d\u2019un texte dans l\u2019un de ces formats le rend m\u00eame illisible pour toute autre chose que par un logiciel de traitement de texte. L\u2019enregistrement d\u2019un fichier dans ces formats, en compilant avec le texte toutes les informations relatives \u00e0 la mise en page, le rend donc inutilisable dans le cadre de ce nouvel horizon de consultation que repr\u00e9sente le Web. D\u2019autant que les traitements de texte n\u2019autorisent qu\u2019un contr\u00f4le partiel sur la gestion des m\u00e9tadonn\u00e9es qui sont pourtant un \u00e9l\u00e9ment fondamental de ce Web s\u00e9mantique. (JULIEN DEHUT, 2018)<\/p><\/blockquote>\n

Markdown : language pivot et normatif<\/h3>\n

Le document num\u00e9rique est un contenu dont la structure est distincte de la mise en forme, et poss\u00e9dant une structure s\u00e9mantique. Mardown r\u00e9pond \u00e0 ces imp\u00e9ratifs : syntaxe simple et intention s\u00e9mantique. Malgr\u00e9 quelques manques dans la syntaxe d’origine (comme les notes de bas de page), on peut voir en MD un standard avec un tronc largement commun ouvrant l’\u00e9criture num\u00e9rique \u00e0 de nombreux horizons. On notera le bel effort de l’\u00e9quipe de https:\/\/commonmark.org<\/a> pour produire une syntaxe unifi\u00e9e.<\/p>\n

<\/p>\n

Markdown est un language pivot qui permet une \u00e9criture num\u00e9rique de qualit\u00e9 et offre \u00e0 ses utilisateurs la possibilit\u00e9 de diffuser le contenu r\u00e9dig\u00e9 en HTML, .doc, .docs, LateX, PDF, ePub …<\/p>\n

Utiliser Markdown<\/h2>\n

Quand vous utilisez un traitement de texte, ce que vous tapez \u00e0 l’\u00e9cran subit directement les modifications de style que vous appliquez. Le r\u00e9sultat est donc ce que vous voyez en temps r\u00e9el \u00e0 l’\u00e9cran (logique imprimerie). Produire un document en markdown se fait le plus souvent de fa\u00e7on diff\u00e9rente au travers de 2 \u00e9tapes : r\u00e9daction\/structuration (au sein d’un logiciel d’\u00e9criture) et \u00ab\u00a0compilation\u00a0\u00bb vers un format de fichier offrant des options de lecture et de mise page (PDF pour l’impression et le desktop, HTML pour le desktop et le mobile avec mise en forme \u00ab\u00a0liquide\u00a0\u00bb, ePub pour les liseuses et le mobile, format word \/ open office, …).<\/p>\n

Comme \u00e9voqu\u00e9 plus t\u00f4t, m\u00eame si le texte\/code \u00e9crit en MD reste lisible par un humain, il n’en demeure pas moins d\u00e9pourvu de mise en forme dans le sens de mise en page. Cependant pour les plus r\u00e9fractaires, il existe des syst\u00e8mes WYSIWYG pour Markdown (on n\u2019est pas \u00e0 un paradoxe pr\u00e8s).<\/p>\n

La syntaxe de base<\/h3>\n

Il ne vous faudra que quelques minutes pour vous familiariser avec la syntaxe[6]<\/a><\/sup> de MD. A titre d’exemple :<\/p>\n

# Titre de niveau 3\n\nOportunum est, ut arbitror, explanare nunc causam, quae ad exitium praecipitem Aginatium inpulit iam inde a priscis maioribus nobilem, ut locuta est pertinacior fama. Nec enim super hoc ulla documentorum rata est fides.\n\n## Titre de niveau 4\n\n**Du Gras**, _de l'Italique_ [un lien](#) quem metuat, aut eum a quo se metui putet? Coluntur tamen simulatione dumtaxat ad tempus. Quod si forte, ut fit plerumque, ceciderunt, tum intellegitur quam fuerint inopes amicorum. Quod Tarquinium dixisse ferunt, tum exsulantem se intellexisse quos fidos amicos habuisset, quos infidos, cum iam neutris gratiam referre posset.\n<\/pre>\n
Sera interpr\u00e9t\u00e9 ainsi :<\/p>\n
Titre de premier 3<\/h3>\n
Oportunum est, ut arbitror, explanare nunc causam, quae ad exitium praecipitem Aginatium inpulit iam inde a priscis maioribus nobilem, ut locuta est pertinacior fama. Nec enim super hoc ulla documentorum rata est fides.<\/p>\n
Titre de niveau 4<\/h4>\n
Du Gras<\/strong>, de l’Italique<\/em> un lien<\/a> quem metuat, aut eum a quo se metui putet? Coluntur tamen simulatione dumtaxat ad tempus. Quod si forte, ut fit plerumque, ceciderunt, tum intellegitur quam fuerint inopes amicorum. Quod Tarquinium dixisse ferunt, tum exsulantem se intellexisse quos fidos amicos habuisset, quos infidos, cum iam neutris gratiam referre posset.<\/p>\n
De l’\u00e9criture \u00e0 la conversion<\/h3>\n
Les \u00e9diteurs plus ou moins WYSIWYG<\/h4>\n
<\/p>\n
Il y a plusieurs ann\u00e9es, Mashable proposait une liste de 78 \u00e9diteurs pour Markdown[7]<\/a><\/sup>. La situation n’a pas tellement chang\u00e9 et un grand nombre de solutions s’offre \u00e0 vous pour vous adonner \u00e0 votre nouvelle passion : \u00e9crire en MD. Vous pourriez vous limiter au bloc-notes standard de votre syst\u00e8me d’exploitation, mais vous risqueriez de passer \u00e0 c\u00f4t\u00e9 de bien des facilit\u00e9s. Ci-dessous une s\u00e9lection maison :<\/p>\n