Markdown : le langage universel pour parler à l'IA

Ce chapitre aborde un sujet plus léger : quelque chose que vous utilisez probablement tous les jours sans en connaître le nom : Markdown.

Laissez-moi commencer par une affirmation audacieuse :

Markdown est le format le plus important que vous devriez apprendre à l’ère de l’IA.

Pourquoi ? Lisez la suite.

Qu’est-ce que Markdown ?

En une phrase : Markdown est une façon d’écrire du texte brut avec une mise en forme contrôlée par des symboles.

Le texte brut n’a pas de mise en forme — pas de titres, pas de gras, pas de listes. D’un autre côté, les formats de texte enrichi comme Word sont trop lourds : ils nécessitent un logiciel spécial pour être ouverts et produisent des fichiers volumineux.

Markdown est le juste milieu : avec quelques symboles simples, vous pouvez ajouter de la mise en forme à du texte brut.

Par exemple, si vous écrivez :

# This is a heading
**This is bold**
- This is a list

Cela s’affiche comme un titre formaté, du texte en gras et une liste. Simple comme bonjour.

Pourquoi vous devez apprendre Markdown à l’ère de l’IA

Raison 1 : L’IA parle Markdown

Avez-vous remarqué que lorsque ChatGPT, Claude, Gemini et autres IA vous répondent, ils incluent automatiquement du texte en gras, des titres, des listes et des blocs de code ?

C’est du Markdown.

L’IA ne produit pas de documents Word ou de PDF. Son format de sortie par défaut est le Markdown. Chaque tableau, texte en gras et bloc de code que vous voyez dans ce tutoriel — tout est en Markdown.

Ne pas apprendre Markdown, c’est comme parler à quelqu’un sans comprendre les mots qu’il écrit. Pouvez-vous encore communiquer ? Oui. Mais c’est bien moins efficace.

Raison 2 : C’est partout

Markdown n’est pas un format propriétaire pour un logiciel spécifique ; c’est un standard universel. Le nombre d’outils qui prennent en charge Markdown est incalculable :

Apprenez un format, utilisez-le partout. Les notes que vous écrivez dans Obsidian conservent leur mise en forme lorsque vous les copiez sur GitHub. Lancez-les à une IA, et elle les comprend parfaitement. Essayez ça avec Word ?

Raison 3 : Des fichiers incroyablement petits

Cela pourrait vous surprendre : Pour un même contenu, un fichier Markdown est plus de 20 fois plus petit qu’un fichier Word.

Pourquoi ? Un fichier Word .docx est essentiellement une archive compressée de fichiers XML, bourrée de définitions de styles, d’informations de polices et de propriétés de document. Même si vous n’écrivez qu’une seule ligne, le fichier fait des dizaines de Ko.

Markdown est du texte brut. La taille du fichier est égale à la quantité de texte que vous écrivez. Pas de bagage supplémentaire.

C’est particulièrement important dans les scénarios IA. Lorsque vous envoyez un document à une IA pour analyse, Markdown consomme moins de tokens, traite plus rapidement et coûte moins cher. Toutes ces balises XML et définitions de style dans un fichier Word sont comptées comme des tokens, du gaspillage.

Raison 4 : L’IA comprend mieux Markdown

Beaucoup de gens ignorent cela.

Si vous donnez à une IA un document Word, elle doit d’abord le convertir en texte. Pendant la conversion, la mise en forme peut être perdue, les tableaux peuvent être désalignés et les images disparaissent.

Donnez à une IA un fichier Markdown, et elle le lit directement. Markdown est lui-même du texte brut — pas besoin de conversion, zéro perte.

Plus important encore, les symboles Markdown (titres avec #, listes avec -, code avec `) sont des instructions sémantiques. L’IA comprend que # Introduction signifie “ceci est un titre de niveau 1”, pas juste du texte en gros. Cela permet à l’IA de mieux comprendre la structure et la hiérarchie de votre document.

Comment apprendre Markdown en 10 minutes

Voici la bonne nouvelle : vous pouvez apprendre 90 % du Markdown que vous utiliserez en 10 minutes.

Les bases (couvrent 80 % des besoins)

1. Titres : Utilisez # pour les titres. Plus vous ajoutez de #, plus le niveau est bas.

``` ``) inherently tell the AI, “this is a heading, this is a list, this is code.” The AI can understand your content structure more accurately.

Learn Markdown in 10 Minutes

There are only about a dozen Markdown syntax elements, and even fewer are needed for daily use. Below, they are ordered by frequency of use, starting with the most common.

1. Headings

Use # followed by a space. The number of # symbols indicates the heading level:

2. **Texte en gras et en italique** : Entourez le texte avec des astérisques.

For daily use, up to level 3 is enough.

2. Bold and Italic

3. **Listes non ordonnées** : Utilisez des tirets.

Bold is used most often, italic occasionally.

3. Lists

Unordered lists use - or *:

4. **Listes ordonnées** : Utilisez des chiffres.

Ordered lists use numbers followed by a period:

5. **Listes imbriquées** : Indentez avec des espaces.

Lists can be nested by adding two spaces before the sub-item:

6. **Code en ligne** : Utilisez des backticks.

4. Code

Inline code uses single backticks:

7. **Blocs de code** : Utilisez trois backticks.

Result: Type claude --help to see help

Code blocks are wrapped with three backticks, and you can specify the language:

8. **Liens et images** : Utilisez des crochets et des parenthèses.

```python
print("Hello World")

9. Citations : Utilisez >.

This is especially useful when communicating with AI. When sending code to an AI, wrap it in a code block so the AI can more accurately identify the code boundaries.

### 5. Links and Images

```

10. **Tableaux** : Utilisez des tirets et des barres verticales.

```

Images are just links with a `!` in front.

### 6. Blockquotes

Start with `>`:

```

11. **Ligne horizontale** : Utilisez trois tirets.

```

Result:

> This is a blockquote.
> It can span multiple lines.

### 7. Tables

```

12. **Texte barré** : Utilisez deux tildes.

```

Table syntax looks complex, but you don’t need to write it by hand. **Just ask the AI to generate it for you.** Say “organize this data into a table,” and the AI will output a Markdown table.

### 8. Horizontal Rules

Three or more `-` on a single line:

```

### Comment utiliser Markdown pour communiquer avec l'IA

**Astuce 1 : Structurez vos invites avec des titres**

Au lieu d'écrire un long paragraphe, utilisez des titres pour diviser votre demande :

```

Used to separate different sections of an article.

### 9. Strikethrough

```

**Astuce 2 : Utilisez des blocs de code pour le code**

Lorsque vous demandez à l'IA d'analyser du code, mettez-le toujours dans un bloc de code :

```

Result: ~~Deleted text~~

---

## That’s Enough, Really

The 9 syntax elements above cover 99% of daily use cases.

**You don’t need to master Markdown.** Headings, bold, lists, and code blocks—master these four and you can handle most situations. Look up the rest when needed.

And Markdown has one advantage: **It’s okay if you can’t remember it all now; you’ll learn it by using it.** AI outputs Markdown, so as you read AI responses every day, you’ll naturally become familiar with these symbols.

---

## How to Use Markdown to Improve Communication with AI

After learning Markdown, here are a few tips to make your conversations with AI more effective:

**Tip 1: Use headings to structure your input**

```

**Astuce 3 : Utilisez des listes pour les exigences**

Lorsque vous avez plusieurs exigences, utilisez des listes :

```

Much better than a big block of text. With headings, the AI can more accurately understand the structure of your request.

**Tip 2: Wrap code in code blocks**

Don’t just paste code directly; wrap it in a code block:

```

### Résumé : Syntaxe Markdown en un coup d'œil

| Syntaxe | Résultat |
|---------|----------|
| `# Titre` | Titre de niveau 1 |
| `## Titre` | Titre de niveau 2 |
| `**Texte**` | **Texte en gras** |
| `*Texte*` | *Texte en italique* |
| `- Élément` | Élément de liste |
| `1. Élément` | Élément de liste numérotée |
| `` `code` `` | Code en ligne |
| ` ``` ` (trois backticks) | Bloc de code |
| `[texte](url)` | Lien hypertexte |
| `![](url)` | Image |
| `> citation` | Citation en bloc |
| `\| Tableau \|` | Tableau |
| `---` | Ligne horizontale |
| `~~texte~~` | ~~Texte barré~~ |

---

## Résumé de ce chapitre

1. **Qu'est-ce que Markdown** : Un format de texte brut avec des symboles de mise en forme légers
2. **Pourquoi apprendre Markdown** : Langage natif de l'IA, omniprésent, fichiers petits, mieux compris par l'IA
3. **Comment apprendre** : 3 minutes pour les bases (titres, gras, listes), 7 minutes pour la syntaxe complète
4. **Syntaxe complète (9 couvrent 99 %)** : Plus les liens, images, citations, tableaux, lignes horizontales
5. **Conseils pour communiquer avec l'IA** : Utilisez des titres pour structurer, mettez le code dans des blocs de code, utilisez des listes pour les exigences

**Points clés à retenir :**

- **Markdown est la "langue maternelle" de l'IA ; l'apprendre, c'est apprendre à communiquer efficacement avec l'IA**
- **Apprenez les bases en 10 minutes, cherchez le reste quand vous en avez besoin**
- **Pas besoin de pratique délibérée ; vous l'assimilerez naturellement en utilisant l'IA**

---

## Partie 2 : API et Tokens : le noyau technique