Aller au contenu principal

Introduction markdown

Markdown est un langage de balisage léger qui permet de formater du texte de manière simple et intuitive, on lui attribue l'extension de fichier .md. Il est souvent utilisé pour écrire du contenu pour le web, comme des articles de blog, des documentations techniques ou des pages web. Pour exemple ce tutoriel est écrit avec ce language de balisage.

Mise en forme du texte

Markdown utilise des symboles simples pour indiquer le formatage du texte :
**Ce mot est en gras** exemple : Ce mot est en gras
_Ce mot est en italique_ exemple : Ce mot est en italique
**_gras-italique_** exemple : gras-italique
~~barré~~ exemple : barré
Faites deux espaces à la suite d'un mot pour aller à la ligne.
Appuyez deux fois sur la touche entrer pour faire un nouveau paragraphe.

Les listes

Pour créer une liste à puces, on utilise des astérisque :

- Elément 1
- Elément 1.1
- Elément 2
- Elément 3
  • Elément 1
    • Elément 1.1
  • Elément 2
  • Elément 3

Pour créer une liste numérotée, on utilise des chiffres suivi d'un point :

1. Elément 1
1. Elément 2
1. Elément 3
  1. Elément 1
  2. Elément 2
  3. Elément 3

Les titres

Markdown permet de créer des titres de différentes tailles. Pour créer un titre de niveau 1, on utilise un dièse :

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

Titre de niveau 2

Titre de niveau 3

Titre de niveau 4

Et ainsi de suite, jusqu'à six niveaux de titres.

Les liens

Markdown permet d'insérer des liens dans le texte. Pour créer un lien, on utilise des crochets pour entourer le texte visible du lien, suivis des parenthèses pour entourer l'adresse URL du lien :

[Cliquez ici pour visiter mon site web](https://www.example.com)

Cliquez ici pour visiter mon site web

Les images

Markdown permet également d'insérer des images dans le texte. Pour créer une image, on utilise la même syntaxe que pour l'ajout d'un lien en ajoutant un point d'exclamation devant :

![Description de mon image](https://www.technolava.com/wp-content/uploads/2015/10/DevOps-logo-cropped2-300x164.png)

Description de mon image

Les tableaux

Pour créer un tableau, on utilise des pipe (|) pour séparer les cellules du tableau et des - pour définir un entête :

| Colonne 1 | Colonne 2 |
| --------- | :-------: |
| Valeur 1 | Valeur 2 |
| Valeur 3 | Valeur 4 |

Pour aligner les colones ont utilise : au moment de définir l'entête, pardéfaut les colonnes sont alignées à gauche.

  • alignement à gauche : :-----
  • alignement à droite : -----:
  • Centrer : :-----:
Colonne 1Colonne 2
Valeur 1Valeur 2
Valeur 3Valeur 4

Conclusion

Markdown est un langage de balisage simple et facile à apprendre. Il permet de formater du texte de manière simple et intuitive, sans avoir à se soucier de la syntaxe HTML.

Exercices

  • Créer un nouveau fichier markdown.
  • Créer des titres de niveau 4, 5 et 6.
  • Ecrire un texte et allez à la ligne après chaque point.
  • Scinder un texte en deux paragraphes.
  • Créer une liste à puces avec des sous-listes.
  • Créer un lien vers un site web.
  • Afficher une image.
  • Créer un tableau avec trois colonnes et trois lignes.

Une fois que vous avez terminé ces exercices, vous devriez avoir une bonne compréhension des bases de Markdown.

Vous pouvez continuer en pratiquant: ici