Markdown: écrire du texte clair et structuré

Le Markdown est un langage de balisage léger qui permet d’écrire du texte enrichi (titres, listes, liens, images, etc.) de manière simple et lisible, sans avoir besoin de connaître le HTML. C’est aujourd’hui un standard très utilisé pour la rédaction de documentation, de cours, de blogs, de notes de projet ou encore de fichiers README sur GitHub.

    6tq 5ttr 6ttr
  • Découverte

Pourquoi utiliser Markdown ?

  • Lisible brut : même sans rendu, le fichier .md reste compréhensible.
  • Facile à apprendre : quelques symboles suffisent à structurer un texte.
  • Universel : utilisé dans GitHub, GitLab, forums, blogs, générateurs de sites statiques (Eleventy, Hugo, Jekyll…).
  • Exportable : peut être converti en HTML, PDF, DOCX, etc.

Les éléments essentiels de Markdown

Voici les notions de base que tu dois connaître pour écrire tes premiers fichiers en Markdown :

Titres

# Titre niveau 1
## Titre niveau 2
### Titre niveau 3

Texte

  • Gras : **mot**mot
  • Italique : *mot*mot
  • Barré : ~~mot~~mot

Listes

  • Liste à puces :

    - Pomme
    - Poire
    - Cerise
  • Liste numérotée :

    1. Étape 1
    2. Étape 2
    3. Étape 3

Liens et images

[Lien vers OpenAI](https://openai.com)

![Texte alternatif](chemin/vers/image.png)

Citations

> Ceci est une citation.

Code

  • Code en ligne : `print("Hello")`print("Hello")

  • Bloc de code (avec coloration syntaxique) :

    ```python
    def hello():
        print("Bonjour Markdown !")
    ```
    

Tableaux

| Nom     | Âge | Ville     |
|---------|-----|-----------|
| Alice   | 22  | Bruxelles |
| Bernard | 31  | Liège     |

Bonnes pratiques

  • Garder des titres hiérarchisés (#, puis ##, puis ###).
  • Ajouter une ligne vide entre deux blocs (par ex. entre un paragraphe et une liste).
  • Utiliser des noms clairs dans les liens et les images.
  • Préférer le gras pour insister sur un mot-clé, pas pour décorer.

Exemple complet

# Recette de brownies

## Ingrédients
- 200 g de chocolat
- 100 g de beurre
- 3 œufs
- 150 g de sucre
- 80 g de farine

## Étapes
1. Faire fondre le chocolat et le beurre.
2. Ajouter le sucre puis les œufs.
3. Incorporer la farine.
4. Cuire 20 minutes à 180°C.

![Brownies](img/brownies.jpg)

À retenir

  • Markdown est simple et universel.
  • Il permet de structurer du texte rapidement, lisible brut et facilement exportable.
  • Il est parfait pour écrire des cours, des notes de projet, ou de la documentation technique.