Bien qu’encore assez méconnu du grand public, le format Markdown présente de gros avantages sur les formats plus connus que sont le docx, l’odt ou le HTML.
Dans cet article, je vous présente les 5 avantages principaux.
Le Markdown : un format simple
Une image vaut mieux qu’un long discours.
Les 3 images ci-dessous représentent la façon dont est représentée un même texte et sa mise en forme dans les formats docx, HTML et Markdown.
Format docx (je n’ai mis qu’1/3 du code, car il est vraiment long) :
Le saviez-vous ? Un fichier docx est en fait un zip qui contient divers fichiers textes au format xml, contenant des liens vers les fichiers images et autres fichiers binaires.
Format HTML :
Format Markdown :
Ceci amène une remarque importante :
Quand on parle de texte mis en forme, il faut bien distinguer 2 choses :
- Son code source, qui est une forme de stockage adaptée aux logiciels
- Son rendu, qui est sa représentation visuelle (ce qu’on voit réellement à l’écran)
Comme vous pouvez le voir sur les image précédentes :
- Le code source du docx est quasiment illisible par un humain. On peut repérer les morceaux de texte et deviner quelques codes de mise en forme, mais ça s’arrête là.
- Le code HTML est déjà plus lisible, mais ce n’est pas encore la panacée….
- Le code Markdown est tout-à-fait lisible par l’humain.
Vous me direz peut-être : on s’en fiche, car tout ce qui nous intéresse c’est le rendu final !
Et vous avez raison…
Mais il y a tout de même un avantage à garder un code source simple : même sans logiciel spécialisé sous la main, vous pourrez lire le texte, et même l’éditer ! Ainsi, à défaut de mieux, même Notepad peut suffire à lire et éditer un fichier Markdown.
La simplicité du Markdown est aussi indirectement la source des avantages qui suivent.
Un format de texte universel
Avec le Markdown, vous pouvez créer des notes, docs, articles, rapports, livres… Et de façon générale, du contenu riche, mais à la mise en page simple.
Voici quelque exemples de la façon dont différents types de personnes peuvent utiliser le Markdown :
- Les étudiants peuvent s’en servir pour prendre leur notes, écrire leurs rédactions, créer leur rapports de stages…etc.
- Les bloggeurs et autres rédacteurs web pourront écrire écrire leur article en Markdown avant des publier.
- Les développeurs pourront écrire en Markdown la présentation et la doc associée au logiciel qu’ils développent
- Les écrivains peuvent écrire leurs livres en Markdown
- Les chercheurs et scientifiques peuvent prendre leur notes ou écrire leur publications en Markdown, y compris des documents contenant des formules mathématiques complexes.
Plus généralement, toute personne ayant besoin de prendre des notes et de créer des documents riches mais à la mise en page simple.
Les éléments de syntaxe du Markdown
Voici les éléments de syntaxe proposés par le format Markdown de base, tel qu’il a été créé en 2004 par John Gruber (cf. cette page) :
- Titres
- Paragraphes et retours à la ligne
- Ligne de séparation
- Italique, gras, mise en exergue
- Listes à puces et numérotées
- Liens hypertextes
- Images
- Extraits et blocs de code
Et voici les éléments de syntaxe étendus qu’il propose aujourd’hui :
- Tableaux
- Cases à cocher
- Exposant et indice
- Surligner ou barrer du texte
- Notes de bas de page
- Liens vers les titres
- Autres éléments spécifiques apportés par des modules externes
- Table des matières
- Icônes
- Formules mathématiques
- Diagrammes
Vous pouvez accéder à mon cours gratuit de 45 minutes en vidéo sur la syntaxe Markdown en cliquant ici.
Un format facile à exporter
Le Markdown est facile à exporter dans d’autres formats :
- formats destinés à être imprimés ou distribués comme le odcx, l’odt et le pdf
- formats destinés à être lus à l’écran, comme le HTML et l’ePub
Comme les capacités de mise en forme de ces formats sont supérieures à celles du Markdown, il n’y a aucune perte de formatage à l’exportation.
Les principaux éditeurs intègrent des fonctions d’exportation dans un ou plusieurs des formats ci-dessus, souvent via l’utilitaire Pandoc. Sinon, vous pouvez utiliser ce dernier directement en ligne de commande.
Pandoc permet aussi d’importer des documents docx et odt dans un fichier Markdown. Mais certaines mises en formes complexes ne seront pas retranscrites.
Un langage extensible
Si le Markdown étendu vu précédemment n’est pas suffisant pour le rendu de votre document, vous pouvez y incorporer du code HTML / CSS.
En effet, les éditeurs Markdown sont capables d’interpréter aussi une partie des langages HTML / CSS. Typiquement, cela vous sera utile pour créer :
- des styles de textes particuliers (par exemple, une police, une couleur ou une décoration particulière)
- des caractères spéciaux, tels que ceux-ci (il y en a des centaines d’autres) : ★ ✓ ✗ ↺ ⇆ ⟶ ⟹
- des audios et vidéos, qui pourront être lus directement dans la page web de rendu
- des tableaux complexes avec des cellules fusionnées
Et la syntaxe reste relativement simple. En voici un exemple :
## Un texte avec des styles et une image redimensionnée
<p style='color:blue; text-decoration:underline; font-size:1.3rem'>Image dimensionnée en relatif par rapport à la largeur de la page : </p>
<img src="../assets/images/markdown_350.png" style="width:10%" alt="logo Markdown" />
## Des caractères spéciaux
★ ✓ ✗ ↺ ⇆ ⟶ ⟹ ⟷ ⟺ ↶
## Des fichiers audio et vidéo :
<audio controls src="../assets/demo_Audio.mp3"/>
<video controls width="500" src="../assets/demo_video.mp4"/>
## Un tableau complexe :
<table>
<tr style="text-align:center">
<th></th>
<th colspan=2>Sans cadre</th>
<th colspan=2>Avec cadre</th>
</tr>
<tr>
<th style="text-align:right">Format</th>
<th>A3</th>
<th>A2</th>
<th>A3</th>
<th>A2</th>
</tr>
<tr>
<td>Poster 1</td>
<td>30 €</td>
<td>40 €</td>
<td>50 €</td>
<td>60 €</td>
</tr>
<tr>
<td>Poster 2</td>
<td>33 €</td>
<td>43 €</td>
<td>53 €</td>
<td>63 €</td>
</tr>
</table>Comme vous pouvez le voir, on incorpore simplement le code HTML dans le code Markdown en laissant une ligne vide entre les deux.
Un choix plus vaste d’éditeurs
Créer un logiciel capable de lire et écrire en Markdown est bien moins difficile que de créer un logiciel pour le format docx. C’est pourquoi il existe plus d’éditeurs Markdown que d’éditeurs docx.
Et je pense que de nouveaux éditeurs Markdown feront leur apparition dans les années qui viennent.
Pour découvrir quels sont les meilleurs éditeurs Markdown existant actuellement sur le marché, je vous invite à regarder la fin de ma vidéo. Son classement des logiciels en 3 catégories vous aidera à choisir le plus adapté à vos besoins.
Et pour découvrir mon éditeur favori en détails, je vous encourage à lire cet article.