Markdown Style Guide

Updated on
Markdown Style Guide

📖 Guide de Style Markdown

Markdown est un langage de balisage léger permettant de formater du texte de manière simple et efficace. Ce guide présente les éléments essentiels de Markdown avec des exemples concrets.

📝 1. Titres (Headings)

Markdown permet d’ajouter des titres en utilisant le symbole # suivi d’un espace.

Syntaxe :

# Titre principal (H1)
## Sous-titre (H2)
### Niveau 3 (H3)
#### Niveau 4 (H4)
##### Niveau 5 (H5)
###### Niveau 6 (H6)

Résultat :

Titre principal (H1)

Sous-titre (H2)

Niveau 3 (H3)

Niveau 4 (H4)

Niveau 5 (H5)
Niveau 6 (H6)

📌 2. Paragraphes et mise en forme

Pour rédiger un paragraphe, il suffit d’écrire du texte normalement en laissant une ligne vide entre deux paragraphes.

Exemple :

Ceci est un premier paragraphe.

Ceci est un second paragraphe.

🔹 Texte en gras et en italique

Syntaxe :

*Italique* ou _Italique_
**Gras** ou __Gras__
***Gras et Italique***

Résultat : Italique ou Italique Gras ou Gras Gras et Italique


🖼️ 3. Images

Les images peuvent être ajoutées avec la syntaxe suivante :

Syntaxe :

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

Exemple :

![Astro Logo](./blog-placeholder-4.jpg)

Résultat : Astro Logo


💬 4. Citations (Blockquotes)

Les citations sont créées en utilisant > au début d’une ligne.

Syntaxe :

> Ceci est une citation.

Résultat :

Ceci est une citation.


📊 5. Tableaux

Les tableaux permettent de structurer des informations.

Syntaxe :

| Nom   | Âge | Ville     |
|-------|-----|----------|
| Alice | 25  | Paris    |
| Bob   | 30  | Lyon     |

Résultat :

NomÂgeVille
Alice25Paris
Bob30Lyon

💻 6. Blocs de Code

Les blocs de code sont entourés de trois accents graves (```), suivis du langage pour la coloration syntaxique.

Exemple en HTML :

  ```html
    <!DOCTYPE html>
    <html>
    <head>
      <title>Exemple</title>
    </head>
    <body>
      <p>Bonjour, monde !</p>
    </body>
    </html>

Résultat :

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Example HTML5 Document</title>
  </head>
<body>
  <p>Ici le corp de la page</p>
</body>
</html>

📋 7. Listes

🔹 Liste ordonnée

Syntaxe :

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

Résultat :

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

🔹 Liste non ordonnée

Syntaxe :

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

Résultat :

  • Élément 1
  • Élément 2
  • Élément 3

🔹 Liste imbriquée

Syntaxe :

- Fruits
  - Pomme
  - Banane
- Légumes
  - Carotte
  - Brocoli

Résultat :

  • Fruits
    • Pomme
    • Banane
  • Légumes
    • Carotte
    • Brocoli

🔤 8. Autres éléments utiles

🔹 Abréviations

<abbr title="HyperText Markup Language">HTML</abbr>

Résultat : HTML

🔹 Indices et exposants

H<sub>2</sub>O (Indice) et X<sup>2</sup> (Exposant)

Résultat : H2O et X2

🔹 Raccourcis clavier

Appuyez sur <kbd>CTRL</kbd> + <kbd>C</kbd> pour copier.

Résultat : Appuyez sur CTRL + C pour copier.

🔹 Texte surligné

Voici un texte <mark>surligné</mark>.

Résultat : Voici un texte surligné.


Conclusion

Ce guide couvre les bases essentielles de Markdown pour rédiger des articles bien structurés et lisibles. Avec cette syntaxe, vous pouvez facilement formater du contenu et améliorer l’expérience utilisateur sur votre site internet.

Bon codage !