Introduction

Le Markdown est un langage de balisage léger qui permet de styliser le texte sur le Web. Il est largement utilisé pour la rédaction de documents, les blogs, et la documentation technique. Ce guide vous aidera à comprendre les bases du Markdown, à intégrer des images, à créer des listes, et à explorer les différences entre le Markdown standard et le GitHub Flavored Markdown (GFM).

Qu'est-ce que le Markdown ?

Markdown permet de formater du texte en utilisant des caractères spéciaux. Il est conçu pour être simple et lisible, même en tant que texte brut. Ce guide couvre les principales syntaxes Markdown et fournit des exemples pratiques.

Guide de syntaxe Markdown

Voici les principales syntaxes Markdown que vous pouvez utiliser.

En-têtes

Pour créer des en-têtes, utilisez le symbole #. Plus il y a de #, plus l'en-tête est petit.

# Ceci est un en-tête de niveau 1 (H1)

## Ceci est un en-tête de niveau 2 (H2)

### Ceci est un en-tête de niveau 3 (H3)

Ceci est un en-tête de niveau 1 (H1)

Ceci est un en-tête de niveau 2 (H2)

Ceci est un en-tête de niveau 3 (H4)

Mise en forme du texte

Italique et gras

Utilisez des astérisques ou des traits de soulignement pour mettre en forme le texte.

_Texte en italique_ ou _Texte en italique_

**Texte en gras** ou **Texte en gras**

Texte en italique ou Texte en italique

Texte en gras ou Texte en gras

Listes

Listes non ordonnées

Pour créer des listes non ordonnées, utilisez des tirets -, des plus +, ou des astérisques *.

- Élément 1
- Élément 2
  - Sous-élément 2.1

• Élément 1
• Élément 2
  • Sous-élément 2.1

Listes ordonnées

Pour les listes ordonnées, utilisez des chiffres suivis d'un point.

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

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

Images

Pour insérer une image, utilisez la syntaxe suivante :

![Logo Markdown](https://markdown-here.com/img/icon256.png)

Vous pouvez également référencer une image locale en utilisant le chemin relatif :

Liens

Pour créer un lien, utilisez la syntaxe suivante :

[Markdown Here](https://markdown-here.com)

Markdown Here

Citations

Pour ajouter une citation, commencez la ligne avec un >.

> Ceci est une citation.

Ceci est une citation.

Code

Code en ligne

Pour inclure du code en ligne, encadrez-le avec des accents graves `.

Utilisez code ici.

Blocs de code

Pour les blocs de code, utilisez trois accents graves.

```js:helloConsole.js
function test() {
console.log("Hello, World!");
}
```

Et voici à quoi cela ressemble: joliment coloré avec des titres de code stylisés!

function test() {
console.log("Hello, World!");
}

Tables

Pour créer une table, utilisez des barres verticales | et des traits d'union - pour séparer les en-têtes des colonnes.

| En-tête 1 | En-tête 2 |
| --------- | --------- |
| Ligne 1   | Ligne 2   |

Différences entre Markdown Standard et GitHub Flavored Markdown

Le GitHub Flavored Markdown (GFM) est une extension du Markdown standard qui ajoute des fonctionnalités supplémentaires, notamment :

• Listes de tâches : Permet d'ajouter des cases à cocher.

- [x] Tâche complétée
- [ ] Tâche à faire

• Tâche complétée

• Tâche à faire

• Syntaxe de code améliorée : GFM prend en charge la coloration syntaxique pour les blocs de code en spécifiant le langage.

```python
def hello():
    print("Hello, World!")
```

def hello():
    print("Hello, World!")

• Support des mentions : Vous pouvez mentionner des utilisateurs en utilisant @nom_utilisateur.

• Support des emojis : Vous pouvez insérer des emojis en utilisant la syntaxe :nom_emoji:.

Conclusion

Le Markdown est un outil puissant pour la rédaction de documents et la création de contenu sur le Web. Avec ce guide, vous avez maintenant les bases nécessaires pour commencer à utiliser Markdown efficacement, ainsi qu'une compréhension des différences entre le Markdown standard et le GitHub Flavored Markdown. N'hésitez pas à expérimenter avec la syntaxe pour découvrir toutes les possibilités qu'elle offre.