[Mise à jour le 10/8/2021]

• Source
  • Markdown Guide : Basic Syntax

Markdown a été conçu pour être aussi facile à lire et à écrire que possible.
La lisibilité, cependant, prime devant tout le reste. Un document formaté selon Markdown devrait pouvoir être publié comme tel, en texte, sans donner l’impression qu’il a été marqué par des balises ou des instructions de formatage.Source

<note>Écrire simplement le texte pour créer un paragraphe. Séparer les paragraphes par une ligne vide.</note>

Exemple

*.md

Ceci est un paragraphe de texte.
 
Ceci est un autre paragraphe de texte !

Résultat
Ceci est un paragraphe de texte.

Ceci est un autre paragraphe de texte !

• Emphase faible (italique)

<note>Entourer le texte d'une simple étoile (*) pour l'afficher en italique et d'une double (* *) pour l'afficher en gras.</note>

Exemple

*.md

Voici un mot *important* à mon sens

Résultat : Voici un mot important à mon sens

• Emphase forte (gras)

Exemple

*.md

Voici des mots **très importants**, j'insiste !

Résultat : Voici des mots très importants, j'insiste !

• Texte barré

Exemple

*.md

Ce texte est ~~barré~~

Résultat : Ce texte est barré

<note>Les titres sont affichés avec le caractère #.</note>

Exemple

*.md

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

Résultat

Titre de niveau 3

• Les listes à puces

<note>Les listes non ordonnées utilisent l’astérisque, le plus, ou encore le tiret — de façon tout à fait interchangeable.</note>

*.md

* Une puce
* Une autre puce
* Et encore une autre puce !

Résultat

• Une puce
• Une autre puce
• Et encore une autre puce !

• Les listes à puces numérotées

<note>Les listes ordonnées utilisent un nombre suivi d’un point.</note>

*.md

1. Et de un
2. Et de deux
3. Et de trois

Résultat

1. Et de un
2. Et de deux
3. Et de trois
   

<note>On utilise le caractère > pour les blocs de citation. </note>

*.md

> Ceci est un texte cité. Vous pouvez répondre
> à cette citation en écrivant un paragraphe
> normal juste en-dessous !

Résultat

Ceci est un texte cité. Vous pouvez répondre
à cette citation en écrivant un paragraphe
normal juste en dessous !

• Bloc de code

<note>Pour produire un bloc de code avec Markdown, vous n’avez qu’à indenter chaque ligne d’un bloc par au moins 4 espaces ou une tabulation.</note>

Exemple et résultat

*.md

Voici un code en C :
 
    int main()
    {
        printf("Hello world!\n");
        return 0;
    }

• Code en ligne

<note>On insère du code dans une ligne de texte en l'entourant du caractère apostrophe '.</note> Exemple

*.md

La fonction 'printf()' permet d'afficher du texte

<note tip>Pour tout autre formatage du code (mise en gras ou en couleur des mots-clés, etc.) il faut utiliser les balises HTML (code et pre) pour formater le code et des règles CSS intégrées dans des balises <span style=““>.</note>

Exemple

*.md

<span style=style="color:blue;">Un texte en bleu</span>

Un texte en bleu

<note>Markdown supporte deux styles de liens : incorporé au texte et par référence. Dans les deux cas, le texte du lien est délimité par des [crochets].</note>

Exemple

*.md

Ceci est [un exemple](http://exemple.com/ "Titre") de lien incorporé.
 
[Ce lien](http://exemple.net/) n'a pas de titre.

<note>Markdown utilise une syntaxe d’image qui ressemble à la syntaxe des liens, permettant deux variantes : incorporé et par référence.</note>

Exemple

*.md

![Texte alternatif](/chemin/vers/img.jpg)
 
![Texte alternatif](/chemin/vers/img.jpg "Titre optionnel")

<note>Vous pouvez produire une ligne horizontale en plaçant au moins trois tirets, astérisques, ou barres de soulignement seuls sur une ligne. </note>

Exemple

*.md

-----------------

Résultat

PHP Markdown Syntaxe lien