Écris une fois, publie partout : apprivoise le markdown

Niveau de difficulté : ✯☆☆

Ça t’est déjà arrivé, forcément.

Tu demandes un plan de cours à une IA. La réponse arrive, bien présentée à l’écran, avec des titres, des listes, du gras aux bons endroits. Tu la copies. Tu la colles dans Word.

Et là, carnage. Des ** partout, des # en début de ligne, des tirets qui ne font plus de puces. Ton beau document ressemble à un fichier de configuration. Tu passes vingt minutes à nettoyer à la main ce que la machine avait mis dix secondes à structurer.

Cette bouillie d’astérisques, elle a un nom. C’est du markdown. Et ce n’est pas un bug : c’est un langage. Un langage que tu utilises déjà sans le savoir, que ton IA parle nativement, et qui — une fois compris — te fera gagner un temps que tu n’imagines pas.

Je te préviens tout de suite : ça s’apprend en un quart d’heure. Vraiment. Il n’y a rien à installer, rien à payer, et aucun risque de casser quoi que ce soit. C’est la compétence numérique au meilleur rapport effort/bénéfice que je connaisse.

📅 Cet article a un petit frère, et il arrive bientôt
Une fois le markdown en main, tu peux dessiner des schémas en les écrivant, avec un outil qui s’appelle mermaid. Ce sera l’objet du prochain article. Commence par celui-ci : le second s’appuie dessus.

Table des matières

C’est quoi, au juste

Reviens un instant à l’époque où tu annotais un texte à la main. Tu voulais insister sur un mot ? Tu le soulignais. Un titre ? Tu le mettais plus gros, ou tu tirais un trait dessous. Une énumération ? Tu faisais des petits tirets dans la marge.

Le markdown, c’est exactement ça, mais tapé au clavier. Des conventions simples pour dire « ceci est un titre », « ceci est important », « ceci est une liste » — sans jamais lâcher le clavier pour aller cliquer dans une barre d’outils.

Deux Américains, John Gruber et Aaron Swartz, l’ont inventé en 2004 (Gruber, 2004). Leur idée tenait en une phrase : un document doit rester lisible tel quel, même sans logiciel pour l’afficher joliment.

Regarde toi-même :

# Module de comptabilité générale

Ce module s'adresse à des adultes **en reprise d'études**.

## Prérequis
- Savoir utiliser un tableur
- Avoir suivi le module d'initiation

Tu as compris la structure sans que personne ne te l’explique. C’est tout le principe. Un fichier markdown est un fichier texte ordinaire — le même genre que le Bloc-notes produit — qui s’ouvre partout, pèse trois fois rien, et sera encore lisible dans vingt ans.

⚠️ Ne confonds pas markdown et traitement de texte
Word te montre le résultat pendant que tu tapes. Le markdown, lui, te fait écrire l’intention — « ceci est un titre de niveau 2 » — et laisse chaque outil décider de son apparence. C’est un peu plus abstrait au départ. C’est infiniment plus portable ensuite.

Pourquoi ça devrait t’intéresser

Cinq raisons, dans l’ordre où elles vont te servir.

1. Ton IA parle markdown, que tu le veuilles ou non. ChatGPT, Claude, Gemini, Mistral : tous structurent leurs réponses en markdown. Quand tu vois du gras dans une réponse, c’est du markdown que l’interface a mis en forme pour toi. Comprendre ce langage, c’est cesser de subir les copier-coller ratés — et surtout pouvoir demander exactement le format que tu veux.

2. Tu écris une fois, tu recycles partout. La même fiche de séquence part dans Notion, devient une présentation dans Gamma, alimente un document Canva et se colle dans ton cours en ligne. Sans jamais retaper.

3. C’est éternel. Ouvre un .doc de 2003, on en reparle. Un fichier .md de 2004 s’ouvre aujourd’hui sans une ride, et s’ouvrira encore quand ton établissement aura changé trois fois de suite d’abonnement bureautique. Pour de la documentation pédagogique qu’on veut garder, ce n’est pas un détail.

4. Ça pèse trois fois rien. Une fiche de dix pages en markdown fait quelques kilo-octets. Tu peux en mettre des milliers dans un espace partagé sans faire hurler ton informaticien.

5. Ça se compare. Deux versions d’un même document markdown se comparent ligne à ligne. Quand une équipe fait évoluer un dossier pédagogique à plusieurs, savoir exactement qui a changé quoi n’a pas de prix.

La syntaxe en dix minutes

Voici tout ce dont tu as besoin pour nonante pour cent de ton usage. Lis la colonne de gauche, regarde la colonne de droite, c’est fini.

Tu tapes ça	Tu obtiens ça
`# Titre principal`	Un titre de niveau 1
`## Sous-titre`	Un titre de niveau 2 (et ainsi jusqu’à `######`)
`important`	important
`nuance`	nuance
`~~supprimé~~`	~~supprimé~~
`- premier élément`	Une puce
`1. première étape`	Une liste numérotée
`[Technopédia](<https://technopedia-cpeons.be/>)`	Un lien cliquable « Technopédia »
`![Légende](photo.jpg)`	Une image
`> Ceci est une citation`	Un bloc mis en retrait
`Ctrl+S`	Du `texte technique` en petits caractères
`---`	Un trait de séparation

Quatre règles de survie, et tu ne te feras jamais avoir :

Un espace après le # et après le -. #Titre ne marche pas. # Titre marche. C’est l’erreur numéro un, et de loin.
Une ligne vide entre deux blocs. Entre un paragraphe et une liste, entre un titre et le texte : laisse respirer.
Les astérisques se ferment. **gras**, pas **gras. Sinon tu obtiens des astérisques à l’écran, ce qui est précisément le problème du début de l’article.
Pas d’espace collé à l’intérieur. ** gras ** ne fonctionne pas. **gras** oui.

💡 Le test qui prend trente secondes
Va sur Dillinger ou StackEdit — deux éditeurs en ligne, gratuits, sans inscription. Tu tapes à gauche, tu vois le résultat à droite, en direct. C’est le bac à sable idéal pour se faire la main, et c’est là que je fais commencer les gens en formation. Pour une référence complète de la syntaxe, consulte le Markdown Guide (Cone, 2026).

Un exemple qui parle

Prends une fiche de séquence, comme tu en produis chaque semaine. Voici à quoi elle ressemble en markdown :

# Séquence 4 — analyser un bilan comptable

**Public :** adultes en reprise d'études, cours du soir
**Durée :** 3 h (deux séances)
**Prérequis :** modules 1 à 3

## Objectifs
À l'issue de la séquence, l'apprenant est capable de :

1. Distinguer l'actif du passif
2. Calculer un fonds de roulement
3. Interpréter trois ratios de solvabilité

## Déroulé

| Temps | Activité | Modalité |
|---|---|---|
| 20 min | Rappel des notions | Collectif |
| 60 min | Étude d'un bilan réel | Binômes |
| 40 min | Mise en commun | Collectif |
| 30 min | Exercice d'application | Individuel |

## Évaluation
> Critère de réussite : l'apprenant identifie les trois ratios
> et justifie chaque interprétation par un chiffre du bilan.

## Remarques
- Prévoir des bilans de PME locales — ça parle davantage
- Le fonds de roulement passe mal en fin de soirée : le placer tôt

Ce texte est lisible tel quel. Collé dans Notion, il devient une page structurée avec un vrai tableau. Envoyé dans Gamma, il devient une présentation. Importé dans Canva, il devient un document mis en page. Donné à une IA, il est compris parfaitement, parce que la hiérarchie est explicite.

Un fichier. Quatre usages. Zéro retape.

Quand tu veux aller plus loin

Six éléments de plus, qui servent moins souvent mais rendent de vrais services.

Les tableaux. Tu viens d’en voir un. La syntaxe :

| Compétence | Niveau visé |
|---|---|
| Analyser un bilan | Autonome |
| Rédiger une note | Accompagné |

Les tirets de la deuxième ligne séparent l’en-tête du contenu. Tu peux même aligner : |:---| à gauche, |---:| à droite, |:---:| au centre. Et bonne nouvelle — l’alignement des barres verticales n’a aucune importance, seul le nombre de colonnes compte.

Les cases à cocher. Parfait pour une liste de préparation ou un suivi de dossier :

- [x] Réserver la salle informatique
- [ ] Photocopier les bilans
- [ ] Prévenir le secrétariat

Les blocs de code. Trois accents graves, un nom de langage, ton contenu, trois accents graves. Ça préserve la mise en forme exacte — indispensable si tu enseignes l’informatique, la bureautique ou les langages de requête.

Les notes de bas de page. Texte[^1] dans le corps, puis [^1]: Ma note plus bas. Pratique pour un dossier pédagogique qui doit citer ses sources.

Le HTML de secours. Le markdown accepte du HTML quand il ne sait pas faire. <br> force un saut de ligne, <u>souligné</u> souligne. À utiliser avec parcimonie : c’est la porte de sortie, pas la règle.

L’en-tête de fiche. Certains outils lisent un bloc encadré de --- en tout début de fichier, où tu ranges des informations sur le document lui-même — titre, auteur, date, mots-clés. On appelle ça le front matter, et il mérite qu’on s’y arrête, parce que c’est lui qui transforme un tas de fichiers en bibliothèque.

Le principe : les toutes premières lignes du fichier ne sont pas le document, ce sont les informations sur le document. On les écrit dans un format appelé YAML, qui se résume à une étiquette, deux points, une valeur :

---
titre: Analyser un bilan comptable
module: Comptabilité générale
niveau: Débutant
public: Adultes en reprise d'études
duree: 3 h
auteur: N. Kohen
date: 2026-09-16
mots-cles: [comptabilité, bilan, ratios]
statut: Validé
---

# Séquence 4 — analyser un bilan comptable

Le vrai contenu commence ici.

Trois règles suffisent : les trois tirets ouvrent et ferment le bloc, une information par ligne sous la forme étiquette: valeur, et l’indentation se fait avec des espaces — jamais de tabulation, c’est la seule erreur qui fait tout échouer. Une liste s’écrit entre crochets, ou en tirets sur des lignes successives.

À quoi ça sert ? À retrouver. Une fiche isolée n’en a pas besoin. Cent fiches de séquence dans un dossier partagé, si : tu peux chercher toutes celles dont le niveau est Débutant, ou dont le statut n’est pas encore Validé. Obsidian et la plupart des outils de notes construisent des tableaux de bord à partir de ces étiquettes, sans que tu écrives une ligne de code.

Deux bénéfices moins évidents. D’abord, une IA à qui tu donnes une fiche avec son en-tête sait immédiatement pour qui elle est écrite et à quel niveau — tu n’as plus à le répéter à chaque demande. Ensuite, c’est un excellent outil de discipline collective : décider en équipe les six étiquettes obligatoires d’une fiche de séquence, c’est se mettre d’accord sur ce qu’on considère comme une fiche complète.

💡 Commence par six étiquettes, pas plustitre, module, niveau, public, date, statut. C’est suffisant pour s’y retrouver, et assez court pour que tes collègues le remplissent vraiment. Un en-tête de vingt lignes que personne ne complète ne sert à rien.

Où est-ce que ça marche vraiment ?

Voilà la question qui compte, et la réponse est plus nuancée qu’on ne le dit. J’ai testé, et voici le tri.

Là où c’est natif et confortable

Outil	Comment ça se passe
Les IA (ChatGPT, Claude, Gemini, Mistral…)	Elles produisent du markdown par défaut. Tu peux leur demander « rends-moi ça en markdown brut, dans un bloc de code » et récupérer du texte propre à recycler.
Notion	Tu tapes `#` et la ligne devient un titre, instantanément. Coller du markdown crée les blocs correspondants. C’est probablement l’outil grand public le mieux fichu pour ça.
Obsidian	Application de prise de notes dont les fichiers sont du markdown, stockés sur ton disque. Le choix des gens qui veulent posséder leurs notes.
GitHub / GitLab	Le markdown y est la langue officielle. Peu utile en formation d’adultes, sauf si tu enseignes l’informatique.
Moodle	Le champ de saisie propose un format « Markdown ». Beaucoup de collègues l’ignorent alors qu’il est là depuis des années.
Discord, Slack, Teams	Le gras, l’italique, le code et les citations fonctionnent dans les messages. Tu l’utilises peut-être déjà sans le nommer.

Là où ça marche, mais à l’import

Outil	Ce qu’il faut savoir
Gamma	Tu déposes un fichier `.md` et il en fait une présentation. La structure en titres se transforme en diapositives — c’est bluffant, et c’est le meilleur usage du markdown pour un formateur pressé.
Canva Docs	Import de fichiers `.md` par glisser-déposer, jusqu’à 5 Mo (Canva, 2026). Attention : l’import fonctionne, l’export non. Un document Canva ne redevient pas du markdown. Vérifie toujours le résultat, certains éléments passent mal.

Là où c’est partiel, et il faut le savoir

Google Docs mérite un paragraphe à lui seul, parce que c’est là que la plupart des gens se cassent les dents.

Il faut d’abord activer l’option (Google, 2026) : Outils → Préférences → coche Activer Markdown. Elle est désactivée par défaut, ce qui explique bien des déconvenues.

Ensuite, ça convertit à la frappe : les titres (#), le gras, l’italique, le barré, les liens et les listes. Mais les tableaux ne passent pas, et les blocs de code non plus. Tu peux aussi importer un .md (Fichier → Ouvrir) et exporter en markdown (Fichier → Télécharger → Markdown), ce qui reste le chemin le plus fiable.

⚠️ Le piège du tableau
C’est l’écueil classique : tu prépares une belle grille d’évaluation en markdown, tu la colles dans Google Docs, et tu récupères une bouillie de barres verticales. Pour les tableaux, passe par l’import de fichier plutôt que par le collage — ou monte-les à la main dans Docs.

Là où ça ne marche pas du tout

Word, PowerPoint, LibreOffice Writer : pas de markdown natif. La parade est simple — colle ton markdown dans un éditeur en ligne comme Dillinger, copie le résultat mis en forme (pas le code), et colle-le dans Word. La mise en forme suit.

Le vrai super-pouvoir : le markdown et l’IA

C’est là que tout se recoupe, et c’est ce que je montre systématiquement en atelier.

Le markdown, c’est la langue commune entre toi, l’IA et tes outils. Trois usages concrets :

Tu demandes du markdown propre. Ajoute à ta demande : « Rends la réponse en markdown, dans un bloc de code, sans commentaire autour. » Tu récupères du texte que tu peux coller directement dans Notion, Gamma ou Canva. Fini le nettoyage à la main.

Tu donnes du markdown. Une structure claire en entrée aide énormément le modèle à comprendre ce qui est un titre, une consigne, une donnée. C’est un des rares gestes de mise en forme qui compte encore vraiment sur les modèles récents — j’y consacrerai prochainement un article à part entière.

Tu fais convertir. « Transforme ce compte rendu en tableau markdown avec trois colonnes : décision, responsable, échéance. » Trois secondes, et tu as un tableau réutilisable partout.

Le markdown et le mermaid

Et si je te disais que le markdown cache un autre super-pouvoir ?

Tu peux y glisser un second langage, qui s’appelle mermaid. Son truc : transformer quelques lignes de texte en schémas. Des organigrammes, des frises chronologiques, des diagrammes de flux — tout ça, sans jamais ouvrir PowerPoint ni aligner des boîtes à la souris.

Le plus beau ? Notion, Obsidian, Excalidraw, GitHub : tous comprennent le mermaid. Et les IA aussi — tu décris ton processus en français, tu demandes du mermaid, tu récupères un schéma prêt à l’emploi. Dix secondes.

📅 La suite arrive la semaine prochaine

L’article sur le mermaid est en préparation. En attendant, voici un avant-goût de ce que ça donne.

flowchart TD
    A["Tu écris en markdown"] --> B["Un seul fichier .md"]
    B --> C["Notion"]
    B --> D["Présentation Gamma"]
    B --> E["Canva Docs"]
    B --> F["Ton IA"]
    B --> G["Moodle"]

Le même texte que celui plus haut, interprêté par le logiciel Excalidraw puis exporté en png. C’est la technique que j’utilise dans chaque article et que je te montrerai bientôt…

Et concrètement, tu en fais quoi ?

Pour toi, tout seul. Commence par un seul geste : la prochaine fois que tu demandes quelque chose à une IA, ajoute « en markdown, dans un bloc de code ». Regarde ce qui sort, colle-le dans Notion ou dans Dillinger. Tu auras compris l’intérêt en une minute.

Ensuite, prends une fiche que tu réécris chaque année et passe-la en markdown. Une seule. Tu verras l’année prochaine à quel point elle est plus facile à faire évoluer.

Pour ton équipe ou ton établissement. C’est là que ça devient stratégique. Une équipe qui range ses fiches de séquence, ses grilles d’évaluation et ses procédures dans des fichiers .md sur un espace partagé se constitue un patrimoine qui ne dépend d’aucun logiciel, d’aucune licence et d’aucun abonnement. Si ton établissement change de suite bureautique, de plateforme ou de fournisseur, tout suit sans conversion.

Et le jour où quelqu’un veut monter une présentation à partir d’un module existant, il dépose le fichier dans Gamma. Trois minutes.

Mieux encore : il peut aussi le donner à une IA. « Voici ma fiche de module en markdown. Transforme-la en support de présentation de douze diapositives, une idée par diapositive, avec une question d’accroche au début de chaque partie. » Comme le fichier est structuré — les titres sont des titres, les listes sont des listes — le modèle sait exactement ce qui est quoi. Il ne devine pas la hiérarchie, il la lit. Et le résultat est sans commune mesure avec ce que tu obtiens en collant un texte informe.

💡 L’argument qui marche en réunion
Ne dis pas « on va passer au markdown », personne ne saura de quoi tu parles. Dis : « on va écrire nos fiches dans un format que tous nos outils comprennent et qu’on n’aura jamais à convertir. » C’est la même chose, et ça s’entend beaucoup mieux.

Verdict

Le markdown n’est pas une technologie. C’est une convention d’écriture, apprise en un quart d’heure, qui a la particularité rare d’être comprise à la fois par les humains, par les logiciels et par les IA.

Ce que j’en retiens après l’avoir enseigné à des dizaines de collègues : ceux qui l’adoptent ne le font jamais pour la raison qu’ils imaginaient au départ. Ils viennent pour arrêter de nettoyer des astérisques. Ils restent parce qu’ils découvrent qu’écrire une fois et publier partout change réellement leur façon de préparer.

Alors ne commence pas par tout convertir. Prends une fiche, une seule, et tape-la en markdown. Les #, les -, les **. Le reste viendra tout seul.

Et quand tu seras à l’aise, rendez-vous au prochain article : on y verra comment dessiner tes schémas de la même manière, en les écrivant. C’est le même principe, et c’est encore plus spectaculaire.

Références

Canva. (2026). Importer des fichiers Markdown dans Canva. Canva Aide. https://www.canva.com/help/import-markdown/

Cone, M. (2026). Getting Started. Markdown Guide. https://www.markdownguide.org/getting-started/

Google. (2026). Utiliser Markdown dans Google Docs. Google Docs Aide. https://support.google.com/docs/answer/12014036?hl=fr

Gruber, J. (2004, 17 décembre). Markdown. Daring Fireball. https://daringfireball.net/projects/markdown/

Outils en ligne

Dillinger — éditeur markdown en ligne gratuit
StackEdit — éditeur markdown en ligne gratuit