Utiliser le Markdown au quotidien

Source 1

Source 2

Qu'est-ce que c'est ?

Le Markdown est un langage de balisage léger créé en 2004 par John Gruber, avec l'aide d'Aaron Swartz, dans le but d'offrir une syntaxe facile à lire et à écrire en l'état dans sa forme non formatée. (Wikipédia consulté le 29/12/2023)

Pour faire simple, c'est l'utilisation dans un texte d'une série de signes (qu'on appelle des balises) tels que # ou * par exemple qui vont permettre de structurer son texte. Dans des traitements de texte comme LibreOffice ou Word, on peut mettre des éléments en gras, en italique ou encore définir des titres de différents niveaux. Tout cela permet d'obtenir à la fin un texte qui est mis en forme. C'est ce que permet de faire le markdown mais dans n'importe quel type de fichier texte y compris dans une simple note sur son smartphone ou dans un fichier texte. Comme le markdown est aussi très simple, les balises se comprennent lors de la simple lecture même si techniquement le texte n'est pas encore "mis en forme" (on lit la balise pour mettre en gras mais le texte n'est pas réellement en gras). Si on le souhaite, on peut par la suite utiliser un programme qui lira ces balises et affichera alors le texte mis en forme. Le markdown se rapproche alors d'un langage de programmation qui peut être autant interprété par un humain que par un ordinateur.

A quoi ça sert concrètement ?

Un simple fichier texte est beaucoup plus léger en poids (et donc plus rapide à ouvrir et plus fluide à parcourir) qu'un fichier généré par un traitement de texte. C'est donc tout naturellement en mobilité que j'ai commencé à l'utiliser. Sur mon téléphone, j'ai pour habitude de rédiger des notes que j'ai donc rapidement voulu structurer. Le markdown me permettait de pouvoir le faire simplement, ne complexifiait pas la lecture et était exportable facilement. J'ai ensuite gardé cette habitude pour la majorité de mes textes y compris sur mes ordinateurs.

Quelles sont les balises ?

• Les paragraphes sont séparés par une ligne laissée vide.

• Deux espaces à la fin d'une ligne produisent un saut de ligne.

• Les titres :

  • # Titre 1
  • ## Titre 2 ... jusqu'à Titre 6

• Lien : [Texte du lien](URL)

• Image :

  • simple : ![](URL de l'image.jpg)
  • complète : ![texte alternatif](URL de l'image.jpg "Titre de l'image")

• Styles de texte :

  • italique : _texte_
  • gras : **texte**
  • gras/italique : **_texte_**
  • barré : ~~texte~~

• Citations : > avant le texte

• Code informatique :

  • si inséré dans le texte : `code `
  • si en bloc indépendant : ```bloc de code```

• Listes :

  • non ordonnées : * avec un espace après puis on rajoute une tabulation devant * pour les sous niveaux
  • ordonées : on remplace * par des chiffres y compris pour les sous-niveaux (attention pas de lettres !)

• Tableaux : il faut utiliser le signe | pour délimiter les colonnes et le signe - pour délimiter les lignes

  • il faut noter que l'alignement n'est pas interpreté, il sert juste à faciliter la lecture "non interprétée"