Tout ce que vous devez savoir sur la syntaxe Markdown pour les débutants
Par Yves, le 3 avril 2023
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
- Élément 1
- Élément 2
- Élément 3
Liste à puces imbriquée dans une liste ordonnée:
1. fruits
* pomme
* banane
2. légumes
- carotte
- brocoli
- fruits
- pomme
- banane
- 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
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
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.