Qu'est-ce que le Markdown ?

Le Markdown est un langage de balisage léger créé en 2004 par John Gruber. Son objectif est simple : écrire pour le web en restant lisible.

Contrairement à Word ou au HTML, le Markdown n'encombre pas votre texte de balises complexes. Vous pouvez le lire tel quel, et il se convertit parfaitement en document riche (comme avec notre outil mdconverter.io).

1. La Structure du Document

Les Titres

Pour créer un titre, ajoutez des dièses (#) devant votre texte. Le nombre de dièses correspond au niveau du titre.

# Titre Principal (H1)
## Sous-titre (H2)
### Titre de section (H3)
#### Petit titre (H4)

Paragraphes et Sauts de ligne

Pour créer un nouveau paragraphe, laissez simplement une ligne vide entre deux blocs de texte.

Pour forcer un retour à la ligne simple (sans changer de paragraphe), terminez votre ligne par deux espaces avant d'appuyer sur Entrée.

Ligne de séparation

Pour créer une ligne horizontale (séparateur), utilisez trois tirets ou plus sur une ligne :

---

2. Mise en forme du texte

Vous pouvez appliquer des styles simples pour mettre l'emphase sur certains mots.

3. Les Listes

Listes à puces

Vous pouvez utiliser des tirets -, des astérisques * ou des plus +.

- Élément 1
- Élément 2
  - Sous-élément (indentez avec 2 espaces)
  - Autre sous-élément
- Élément 3

Listes numérotées

Il suffit de mettre un chiffre suivi d'un point. L'ordre des chiffres dans le code n'importe pas, Markdown les corrige automatiquement lors de l'affichage.

1. Premier point
2. Deuxième point
3. Troisième point

Listes de tâches (Checklists)

Idéal pour les To-Do lists.

- [x] Tâche terminée
- [ ] Tâche à faire
- [ ] En attente

4. Liens et Images

C'est ici que le Markdown brille par sa simplicité par rapport au HTML.

Liens hypertextes

La syntaxe est [Texte du lien](URL).

Visitez [Aikini Agence Web](https://www.aikini.fr) pour vos projets.

Images

C'est comme un lien, mais avec un point d'exclamation ! devant. ![Texte alternatif](URL de l'image)

![Un chat qui code](https://placekitten.com/800/400)

Astuce : Vous ne pouvez pas redimensionner une image en pur Markdown. Si vous avez besoin d'une taille précise, utilisez une balise HTML : <img src="..." width="300">.

5. Citations et Code

Citations (Blockquotes)

Utilisez le signe supérieur > pour mettre en exergue un texte.

> Le Markdown est la façon la plus pure d'écrire.
>
> — Un développeur anonyme

Code (Pour les développeurs)

Pour du code en ligne (au milieu d'une phrase), utilisez un seul accent grave (backtick) : `code`.

Pour un bloc de code entier, utilisez trois accents graves et spécifiez le langage pour la coloration syntaxique :

<?php
echo "Hello World";
?>

6. Les Tableaux

Les tableaux sont souvent la bête noire des débutants, mais la syntaxe est logique. Utilisez des barres verticales | pour séparer les colonnes et des tirets - pour l'en-tête.

| Produit | Prix | Stock |
| :--- | :---: | ---: |
| Pomme | 1€ | 50 |
| Banane | 2€ | 10 |

Les deux points (:) définissent l'alignement :

• :--- = Gauche
• :---: = Centré
• ---: = Droite

7. Astuces Avancées

Échapper des caractères

Si vous voulez écrire un astérisque sans qu'il devienne de l'italique, mettez un antislash \ devant. Exemple : \*Ceci n'est pas en italique\*.

HTML brut

Le Markdown est compatible avec le HTML. Si une mise en forme n'existe pas en Markdown (comme centrer du texte ou changer la couleur), vous pouvez écrire directement en HTML.

<div style="text-align: center; color: red;">
    Texte centré et rouge via HTML
</div>

Vous maîtrisez maintenant 99% du Markdown ! Prêt à convertir vos premiers documents ? Remontez en haut de page et cliquez sur le bouton LANCER L'OUTIL.