Tout ce que vous devez savoir sur la syntaxe Markdown pour les débutants

Par Yves, le 3 avril 2023

Tout ce que vous devez savoir sur la syntaxe Markdown pour les débutants

La syntaxe Markdown est un langage de balisage léger utilisé pour formater des documents. Il est largement utilisé dans les documents de développement, les fichiers README, les pages Web et les blogs. La syntaxe est facile à utiliser et à comprendre, même pour les débutants. Dans cet article, nous allons explorer les bases de la syntaxe Markdown et vous montrer comment l'utiliser pour créer des documents bien formatés.

Les éléments de base

Les titres

Pour créer des titres, vous devez ajouter un ou plusieurs signes dièse (#) avant le texte. Vous pouvez utiliser jusqu'à six signes dièse pour créer différents niveaux de titres.

Exemple :

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

donne

Titre de niveau 1

Titre de niveau 2

Titre de niveau 3

Titre de niveau 4

Les paragraphes

Les paragraphes sont créés en laissant une ligne vide entre deux blocs de texte.

Exemple :

Ceci est un paragraphe.

Ceci est un autre paragraphe.
Les caractères _italiques_, **gras**, `à taille fixe`.

Les caractères italiques, gras, à taille fixe.

Filet:

---


Les listes

Les listes peuvent être ordonnées ou non ordonnées. Pour créer une liste non ordonnée, ajoutez un astérisque (*) ou un tiret (-) avant chaque élément de la liste. Pour créer une liste ordonnée, ajoutez un nombre suivi d'un point.

Exemple :

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

1. Élément 1
2. Élément 2
3. Élément 3

donne

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

Liste à puces imbriquée dans une liste ordonnée:

  1. fruits
     * pomme
     * banane
  2. légumes
     - carotte
     - brocoli
  1. fruits
    • pomme
    • banane
  2. légumes
    • carotte
    • brocoli

Les liens

Pour créer un lien, mettez le texte du lien entre crochets, suivi de l'URL entre parenthèses.

Exemple :

[Ceci est un lien](https://www.example.com)

donne

Ceci est un lien

Les images

Pour ajouter une image, utilisez la même syntaxe que pour les liens, mais avec un point d'exclamation devant les crochets.

Exemple :

![Ceci est une image](GalerieBlog-Article-063-Markdown.webp "Ceci est une image")

donne

Ceci est une image

Les éléments avancés

Les blocs de code

Les blocs de code sont créés en entourant le code avec trois accents graves (```) avant et après le bloc de code (ignorer les \ qui sont là pour l'affichage de l'exemple sur le site).

Exemple :

\```
console.log("Ceci est un bloc de code");
\```

donne

console.log("Ceci est un bloc de code");

Les citations

Les citations sont créées en ajoutant un chevron (>) avant la ligne de citation.

Exemple :

> Ceci est une citation.

donne

Ceci est une citation.

La syntaxe Markdown est un langage de balisage léger et facile à utiliser pour formater des documents. Nous avons examiné les éléments de base et les éléments avancés de la syntaxe dans cet article. Nous espérons que vous avez trouvé cela utile pour créer des documents bien formatés. N'oubliez pas que la pratique rend parfait, alors continuez à utiliser Markdown pour améliorer vos compétences.

Pas encore de commentaire

Vous devez être connecté pour poster un commentaire.

banner