Guide de syntaxe Markdown : référence complète avec exemples

Guide de syntaxe Markdown

Markdown est un langage de balisage léger qui convertit le texte brut en HTML formaté. Créé par John Gruber en 2004, il est devenu le format d'écriture standard pour la documentation, les fichiers README et le contenu technique sur le web.

Titres

Utilisez des symboles #. Un # pour le niveau supérieur, jusqu'à six pour le plus profond :

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Les niveaux doivent augmenter d'un à la fois — passer directement de ## à #### peut dérouter les lecteurs d'écran.

Formatage du texte

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

Liens

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Images

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

Le texte alternatif est essentiel pour l'accessibilité et le SEO — il s'affiche lorsque les images ne parviennent pas à se charger.

Listes

Les listes non ordonnées utilisent -, * ou +. Les listes ordonnées utilisent des nombres :

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

Code

Le code en ligne utilise des accents graves simples : `printf()`.

Les blocs de code utilisent trois accents graves avec un identifiant de langage facultatif :

```python
def greet(name):
    return f"Hello, {name}!"

Langages pris en charge : `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Citations

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

Courantes pour les encadrés, les notes et la citation de sources externes.

Règles horizontales

Trois tirets, astérisques ou tirets bas ou plus sur une ligne :

---
***
___

Tableaux

Les barres verticales et les tirets définissent les colonnes. Les deux-points contrôlent l'alignement :

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

Extensions GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) ajoute des fonctionnalités utiles :

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM crée également des liens automatiques vers les URL — www.example.com devient cliquable sans être entouré de < >.

Échappement des caractères spéciaux

Préfixez avec \ pour afficher les caractères Markdown littéraux :

\*This is not italic\*
\# This is not a heading

Caractères nécessitant un échappement : \ ` * _ { } [ ] ( ) # + - . ! | ~.

Aperçu Markdown en ligne

Utilisez l'outil d'aperçu Markdown pour écrire et prévisualiser du Markdown en temps réel. L'aperçu en direct se met à jour pendant que vous tapez, montrant exactement comment les titres, les liens, les images, les blocs de code et les tableaux seront rendus.