Markdown

<google uid="C08" position="left"></google>

Markdown est un langage à balises léger convertit ensuite en page en HTML ou en XHTML. Cette notation est populaire notamment sur les sites comme GitHub, Stack Overflow ou reddit.

Syntaxe usuelle

Note : les caractères interprétés peuvent être échappés en précédant par un anti-slash exemple '\#' affichera un dièze aulieu d'un en-tête h1.

En-têtes

HTML propose six niveaux d'en-têtes (h1 à h6). En markdown :

# h1

## h2

##### h5

Les 2 premiers niveaux ont une syntaxe alternative :

 h1
 ===================

 h2
  --------------------

Les lignes horizontales

Ici on a le choix dans la syntaxe :

* * *
***
*****
- - -
---------------------------------------

Paragraphes

Les paragraphes sont séparés par une ligne au moins.

Pour forcer un retour à la ligne ajoutez deux espaces en fin de ligne.

gras et italique

**gras** ou __gras__ donne gras

*italique* ou  _italique_  donne italique

Code

Pour ajouter des bouts de code, entourez le d'anti-quotes ` ou pour un bloc, indentez avec 4 espaces :

    echo "Salut";
    echo " monde !";

Listes

* 1er item
    * un sous item
* 1 autre item

1. item numéroté
   1.1. sous item
2. le 2e

Citations

Précedez la citation par un le signe supérieur > :

> " Horum omnium fortissimi sunt Belgae, propterea quod a cultu atque humanitate provinciae longissime absunt, minimeque ad eos mercatores saepe commeant atque ea quae ad effeminandos animos pertinent inportant, proximique sunt Germanis, qui trans Rhenum incolunt, quibuscum continenter bellum gerunt."

Cela sera convertit en HTML : <source lang="html4strict">

Horum omnium fortissimi sunt Belgae, propterea quod a cultu atque humanitate provinciae longissime absunt, minimeque ad eos mercatores saepe commeant atque ea quae ad effeminandos animos pertinent inportant, proximique sunt Germanis, qui trans Rhenum incolunt, quibuscum continenter bellum gerunt.

</source>

Liens

[Titre du lien](le lien ici)
Ex : [Bricosoft](http://bricosoft.com)

On peut définir les liens dans une liste de références.

La référence :

[Titre du lien][reference]

Pour afficher la liste (en pied de page par exemple) :

[reference]: le lien "Titre du lien"

Images

soit :

![Titre de l'image](/chemin/vers/limage.png)

soit :

![Titre de l'image](/chemin/vers/limage.png "autre titre")

Comme pour les liens on peut faire une liste de références :

![Titre][num]

Plus loin :

[num]: url/vers/l/image  "titre"

Liens

• Syntaxe Markdown complète