Pourquoi écrire en Markdown ?

Depuis quelques temps, je parle beaucoup de Markdown, de l'utilisation que j'en ai et des outils que j'utilise, mais jamais des raisons de cette utilisation. Je vais essayer de lister ici les quelques raisons qui me font utiliser Markdown au quotidien, et quelques pistes si vous voulez vous y mettre ! :)

J'ai d'abord choisi d'écrire en Markdown, un peu par obligation. Quand j'ai migré le blog sur Pelican il y a presque un an, je me suis retrouvé à écrire tous mes billets en Markdown¹. Et c'est petit à petit que je me suis mis à ne trouver que — ou presque — des avantages au Markdown.

D'abord, il est super léger, et ne nécessite qu'un simple éditeur de texte. Les fichiers sont écrits en simple texte, en donc ne nécessite pas d'installer un quelconque logiciel supplémentaire sur son ordinateur (pas besoin de Microsoft Office, de LibreOffice, ou iWorks). À ma connaissance, tous les OS d'aujourd'hui disposent, en natif après l'installation, d'un éditeur de texte. Donc on peut écrite en Markdown sur tous les OS, sans rien installer. Même Windows a le Bloc-Notes !

L'avantage d'utiliser Markdown, c'est de posséder une syntaxe claire et légère pour définir la mise en forme. Par exemple, pour écrire une portion de texte en gras, il suffit de l'entourer de deux symboles * ou de deux _. Exemple : J'aime **beaucoup** les Kinder devient « J'aime beaucoup les Kinder ». Pour mettre du texte en italique, il suffit d'un seul de ces symboles (_bonjour_ devient « bonjour »).

On peut aussi écrire des listes en commençant les lignes par des tirets, faire des citations, des liens hypertextes, etc...

L'avantage d'une syntaxe aussi légère est — à mon avis — double :

• Le fichier Markdown est lisible tel quel. En quelques minutes, vous êtes déjà habitué à comprendre que du texte entouré de deux étoiles est important, car en gras, que les lignes débutant par des tirets forment une liste, etc... Si vous ne me croyez pas, reprenez la capture d'écran du bloc-notes Windows un peu plus haut. Le texte est parfaitement lisible, même sans mise en forme².
• Ensuite, on peut écrire du Markdown, avec de la mise en forme, n'importe où. Vous êtes devant un ordi, ouvrez un éditeur de texte. En voiture, dans le bus, le métro, sans PC, pas de souci ! Envoyez vous un sms, un mail, créez une note dans Evernote ou autre, et vous n'aurez à faire qu'un copier-coller une fois rentré chez vous pour retrouver votre texte, parfaitement mis en forme³.

Je trouve qu'un des principaux avantages du Markdown est justement ici : ne pas avoir à se soucier de la forme. Combien de fois est ce que vous avez fini des rapports ou des présentations parce que vous avez passé 80% du temps à mettre en forme trois phrases, pour vous rendre compte, après coup, que vous devez tout refaire parce que le contenu est trop grand/large/différent ? Avec Markdown, vous pouvez vous contrefoutre de la forme. Le plus important c'est ce que vous dites, c'est le contenu. Le reste, c'est du pipeau pour se donner un genre parce qu'on sort un document tout beau tout propre. Alors qu'au final, la forme, on s'en branle un peu, le plus important c'est ce qu'on met dedans.

Pour la petite histoire, j'ai des collègues qui pensent que, si vous leur passez un Word ou un PowerPoint « de travail » avec du texte noir sur fond blanc, c'est un travail baclé que vous avez fait à l'arrache. Juste parce qu'il n'y a pas de mise en forme.

Le meilleur contre-exemple, c'est quand même les scénarios. Les mecs écrivent des histoires de malades, dépensent des millions de dollars pour tourner des supers films avec des caméras 4K (TK), et au final le script est juste écrit en Courier New et sans mise en forme de malade⁴.

Pour ma part, quand je veux générer des PDF ou des ODT un peu classes, j'utilise pandoc et des feuilles de style, propres au format de destination. Je ne vais pas faire de tuto (enfin, pas tout de suite), mais ce site est pas trop mal pour débuter.

Enfin, je ne peux pas finir ce — long — post sans parler des inconvénients de Markdown. Perso, je n'en ai pas vu des masses. Si tant est qu'on ait un éditeur de texte qui le supporte, la lecture d'un source .md est super simple, l'écriture aussi.

Générer des PDF ou autres, c'est un peu plus tendu pour les non connaisseurs, mais je des outils intègrent déjà ce genre de fonctionnalités (comme Uberwriter par exemple).

Enfin, Markdown ne gère pas encore tout ce qu'on peut avoir envie de faire dans un document texte. Pour taper du texte « simple » (j'entends par là, du texte avec mise en avant (gras, italique, souligné), listes à puces ou numérotées, titres, liens, images, ...), c'est royal, mais quand on arrive sur des bibliographies ou des trucs un peu plus exotiques, c'est — à ma connaissance — pas géré nativement par Markdown⁵.

En conclusion : utilisez Markdown, c'est bon, ça mord pas, et ça fait de la place sur les disques !

Quelques liens que j'ai vu passer récemment chez urbanbike :

• Markdown, à quoi ça sert ?
• Apprendre Markdown simplement en 8 jours (sans déconner, testez Markdown !)
• Si vous voulez tester Markdown directement dans votre navigateur6
• Utiliser Markdown en entreprise et utiliser Markdown en entreprise (2)