1. Introduction : Qu'est-ce que le Markdown ?

Le Markdown est un langage de balisage léger qui permet de mettre en forme un texte à l'aide de caractères simples du clavier. Contrairement aux traitements de texte traditionnels (comme Microsoft Word), où il faut utiliser la souris pour mettre du texte en gras ou créer des titres, avec Markdown tout se fait pendant l'écriture dans un simple éditeur, comme le Bloc-notes de Windows.

Pourquoi est-il si important aujourd'hui ?

Aujourd'hui, c'est un standard invisible mais omniprésent. Il est massivement utilisé pour plusieurs raisons :

• Lisibilité absolue : Un document écrit en Markdown peut être lu parfaitement même sans programme spécial pour l'afficher. Le texte reste propre et direct.

• Compatibilité : Comme il s'agit de texte brut, vous pouvez l'ouvrir sur n'importe quel appareil (mobile, Windows, Mac, Linux) sans que la mise en forme ne se dégrade.

• Le standard du web : Beaucoup des outils que nous utilisons chaque jour, comme Wikipedia, utilisent des systèmes de balisage pour organiser l'information. C'est aussi le format préféré des CMS (systèmes de gestion de contenu) modernes pour publier des articles rapidement et efficacement.

• Le langage des IA : Si vous y avez prêté attention, lorsque vous interagissez avec une intelligence artificielle (comme ChatGPT ou Gemini), les réponses apparaissent bien structurées avec des titres et des listes. C'est parce que les IA " parlent " et comprennent naturellement le Markdown pour mieux communiquer avec nous.

2. Syntaxe de base : comment l'écrire ?

Allons droit au but avec la syntaxe. Le secret du Markdown, c'est qu'il utilise des symboles que nous connaissons déjà pour " dessiner " la structure du texte.

Pour mettre en forme un texte, il suffit d'ajouter quelques caractères avant ou autour du texte. Voici les plus importants :

Titres et en-têtes

On utilise le dièse (#). Plus vous mettez de dièses, plus le titre sera petit (jusqu'à 6 niveaux).

Titre principal (H1)

Sous-titre (H2)

Section (H3)

 # Titre principal (H1)
 ## Sous-titre (H2)
 ### Section (H3)

Styles de texte

Pour mettre certains mots en valeur, inutile de chercher des menus déroulants :

• Pour le gras, entourez le texte de deux astérisques ** :

**Texte en gras**

• Pour le texte en italique, entourez le texte d'un astérisque ou d'un tiret bas :

*Italique ou _texte en italique_*

• Pour du texte barré, utilisez deux tildes ~~

~~Texte barré~~

Listes

Idéales pour organiser rapidement des idées :

• Listes non ordonnées : Utilisez un astérisque, un plus ou un tiret (*, +, -).

	Liste non ordonnée de 3 lignes :
		* ligne 1
		* ligne 2
		* ligne 3

• Listes numérotées : Écrivez simplement le numéro suivi d'un point (1., 2.).

	Liste numérotée de 3 lignes :
		1. ligne 1
		2. ligne 2
		3. ligne 3

Tableaux

Dans la plupart des versions de Markdown, les tableaux sont pris en charge, comme celui-ci :

La syntaxe est la suivante :

|Head 1 | Head 2 |
| ------| -----------:|
| data  1  | right data 1 |
| data  2 | right data  2|

Liens et images

Les liens ont un format un peu plus complexe. Par exemple, pour créer un lien vers cette page Markdown de Wikipedia, on écrira :

[Markdown](https://fr.wikipedia.org/wiki/Markdown)

Pour insérer une image, il suffit d'ajouter un point d'exclamation devant :

![Description](URL de l'image)

Blocs

Markdown permet d'encapsuler des textes dans des blocs comme celui-ci :

block quote

Voici la syntaxe :

> block quote

En dehors des IA, où est-il encore utilisé ?

Le " Markdown " de WhatsApp

Savez-vous que WhatsApp utilise une version simplifiée (un " mini-format ") ? Pour écrire en gras, en italique ou en barré, il faut faire :

	*gras*
	_italique_
	~barré~

En plus de Wikipedia et des chats, le Markdown règne dans ces environnements :

• GitHub et GitLab : Ce sont les plateformes où les programmeurs stockent leur code. Tous les manuels d'instructions (appelés README.md) sont écrits en Markdown.

• Reddit et Discord : Ces réseaux sociaux et plateformes communautaires utilisent Markdown pour permettre aux utilisateurs de formater rapidement leurs messages et publications.

• Notion : L'un des outils d'organisation et de prise de notes les plus populaires auprès des étudiants et des entreprises. Vous pouvez écrire directement en Markdown pour créer des pages structurées.

• Trello et Slack : Outils de gestion de projet et de communication interne en entreprise, qui permettent aussi l'usage du gras, des listes et du code avec cette syntaxe.

• Plateformes de blogging : Des sites comme Ghost ou même WordPress (via l'éditeur Jetpack) permettent d'écrire directement en Markdown pour gagner du temps.

Un détail curieux

Beaucoup de ces sites proposent ce qu'on appelle le " WYSIWYG " (What You See Is What You Get), mais presque tous disposent aussi d'un onglet ou d'une option pour écrire directement en Markdown, car c'est bien plus rapide une fois que l'on en maîtrise les astuces.

3. Outils recommandés : où puis-je écrire ?

Options en ligne (sans rien installer)

Idéales pour une première prise en main en classe :

• StackEdit : Un éditeur très puissant qui fonctionne directement dans le navigateur. Il permet de voir en temps réel le rendu du texte à droite pendant que vous écrivez à gauche.
• Dillinger : Très simple et épuré, parfait pour exporter rapidement en PDF ou HTML.
• HackMD : Excellent pour travailler de façon collaborative sur un même document, comme un Google Docs mais en Markdown.

Syntaxe Markdown de base

Presque toutes les applications Markdown prennent en charge la syntaxe de base décrite dans le document de conception original de Markdown :

Document de conception Markdown original

Pour Windows et Mac (bureau)

Ces applications offrent une expérience plus soignée et permettent de gérer de nombreux fichiers :

• Obsidian (gratuit) : C'est l'outil du moment. Il permet de créer un " second cerveau " en reliant les notes entre elles. Il est très visuel et personnalisable.
• Typora : Très minimaliste. Au fur et à mesure que vous écrivez le code (comme gras), le programme le transforme visuellement à l'instant, sans avoir besoin d'un écran partagé.
• Visual Studio Code : Si vos élèves s'intéressent à la programmation, c'est l'éditeur standard de l'industrie, avec un excellent support natif pour Markdown.

Spécifiques pour Mac

• Bear : Une application au design très soigné et élégant, très populaire pour prendre des notes rapidement.

Exportation : le grand avantage

L'une des choses qui vous plairont le plus est qu'une fois le document rédigé, presque tous ces outils permettent de l'exporter en un seul clic vers :

1. PDF (pour rendre des travaux avec une mise en page parfaite).
2. HTML (pour le publier sur un site web).
3. Microsoft Word (s'il faut continuer à l'éditer là-bas).

Le Markdown est flexible. Même s'il a sa propre syntaxe, il est totalement compatible avec le code HTML. Cela signifie que si, à un moment donné, vous avez besoin d'un format que Markdown n'offre pas nativement (par exemple changer la couleur d'un texte, redimensionner une image ou créer un tableau très complexe), vous pouvez écrire directement des balises HTML dans votre fichier .md. Le processeur les reconnaîtra et les appliquera correctement au résultat final.

Mais comment cela fonctionne-t-il ?

Pour comprendre comment on passe d'un texte rempli de symboles (Markdown) à un document beau et professionnel, il faut comprendre deux éléments clés qui travaillent " en coulisses " : le parseur et le CSS.

Le parseur : le traducteur

Un parseur (ou analyseur syntaxique) est un programme qui lit votre fichier Markdown et " comprend " sa structure. Son fonctionnement peut se résumer ainsi :

1. Lecture : Il parcourt le texte caractère par caractère.
2. Identification : Lorsqu'il trouve un symbole spécial (comme ##), il sait que ce qui suit est un titre de niveau 2.
3. Conversion : Il transforme ces symboles en code que le navigateur ou l'ordinateur peut traiter, généralement du HTML.

    Exemple: **Bonjour** le parseur le convertit en <strong>Bonjour</strong>

Le CSS : l'habit du document

Si le parseur fournit le squelette (HTML), le CSS (Cascading Style Sheets) décide de son apparence. Le Markdown, à lui seul, n'a ni couleur, ni typographie, ni tailles fixes ; c'est la feuille de style CSS qui définit :

• Couleurs : Si les titres sont bleus ou noirs.
• Typographie : Si la police est une Arial classique ou une autre plus moderne.
• Espacement : La marge entre les paragraphes ou la largeur de la page.

Différence clé : Le Markdown dit ce qu'est chaque élément (ceci est un titre, ceci est une liste), tandis que le CSS dit à quoi cela ressemble (le titre fait 24px et est vert).

Pourquoi ce tandem est-il si pratique ?

Cette séparation entre contenu (Markdown) et design (CSS) est ce qui rend le système si puissant :

1. Propreté totale : En tant que rédacteur, vous n'êtes pas distrait par les couleurs ou les polices ; vous écrivez simplement. Le document reste toujours " propre ".
2. Changement de style instantané : Vous pouvez écrire un document une seule fois et, simplement en changeant le fichier CSS, lui donner l'apparence d'un article scientifique, d'un billet de blog minimaliste ou d'un rapport d'entreprise.
3. Exportation professionnelle : Les outils que nous avons vus (comme Obsidian ou Typora) utilisent des parseurs et des CSS internes pour générer des PDF qui semblent réalisés par un graphiste, sans que vous ayez eu à toucher au moindre réglage de mise en forme.

4. Références et ressources pour aller plus loin

Vídeos

• Aprende Markdown DESDE CERO y en 10 minutos
• What is markdown?
• Tutorial de Markdown. Creación de notas Markdown en Obsidian.
• Learn Markdown: a quick and easy way to create websites, presentations, documents, and more

Sites de référence

• The Markdown Guide

• CommonMark : C'est le site qui définit le standard du langage pour éviter les confusions entre différents programmes.

• Débuter avec Markdown

• [Markdown Guide: Un guide interactif et très complet (en anglais, mais très visuel) avec des exemples de syntaxe de base et avancée.

](https://www.markdownguide.org)