Introduction

Markdown est un langage de balisage léger qui permet de créer du contenu structuré de manière simple et lisible. Hugo l’utilise nativement pour générer des pages statiques.

Ce document présente les principales syntaxes Markdown compatibles avec Hugo, accompagnées d’exemples concrets.

1. Titres

Pour créer des titres, utilisez les dièses (#). Le nombre de dièses correspond au niveau du titre.

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

Rendu

Titre de niveau 1

Titre de niveau 2

Titre de niveau 3

2. Texte en italique et en gras

Pour mettre du texte en italique ou en gras, utilisez des astérisques (*) ou des tirets bas (_).

*Texte en italique* ou _Texte en italique_
**Texte en gras** ou __Texte en gras__

Rendu

Texte en italique ou Texte en italique Texte en gras ou Texte en gras

3. Listes

Listes à puces

Utilisez des tirets (-), des astérisques (*) ou des signes plus (+).

- Élément 1
- Élément 2
  - Sous-élément
* Élément 3

Rendu

• Élément 1

• Élément 2

  • Sous-élément

• Élément 3

Listes numérotées

Utilisez des nombres suivis d’un point.

1. Premier élément
2. Deuxième élément
3. Troisième élément

Rendu

1. Premier élément
2. Deuxième élément
3. Troisième élément

4. Liens et images

Liens

[Texte du lien](https://example.com)

Rendu

Texte du lien

Images

![Texte alternatif](https://example.com/image.png)

Rendu

5. Citations

Utilisez le signe > pour créer une citation.

> Ceci est une citation.

Rendu

Ceci est une citation.

6. Code

Code en ligne

Encadrez le code avec des backticks.

Voici un exemple de `code en ligne`.

Rendu

Voici un exemple de code en ligne.

Blocs de code

Utilisez trois backticks et précisez éventuellement le langage.

```javascript
function exemple() {
  console.log("Ceci est un bloc de code");
}
```

Rendu

function exemple() {
  console.log("Ceci est un bloc de code");
}

7. Tables

Les tables utilisent des barres verticales (|) et des tirets (-).

| Colonne 1 | Colonne 2 | Colonne 3 |
|-----------|-----------|-----------|
| Valeur 1  | Valeur 2  | Valeur 3  |
| Valeur A  | Valeur B  | Valeur C  |

Rendu

8. Lignes horizontales

Utilisez trois tirets.

---

Rendu

9. Listes de tâches

Les listes de tâches utilisent des crochets.

- [x] Tâche terminée
- [ ] Tâche en cours

Rendu

• Tâche terminée
• Tâche en cours

Conclusion

Markdown, combiné à Hugo, permet de produire rapidement du contenu structuré, lisible et maintenable. Cette base couvre les éléments essentiels pour rédiger des articles, de la documentation ou des pages techniques.

Vous pouvez enrichir davantage vos contenus avec les shortcodes Hugo, la coloration syntaxique avancée et les fonctionnalités spécifiques à votre thème.