Markdown est un langage de présentation minimaliste, inspiré des règles en usage dans les mails et sur Usenet. Un texte écrit en Markdown doit être lisible tel quel, sans donner l'impression d'être formaté.

Ci-dessous sont présentées les règles de base de cette syntaxe. N'hésitez pas à faire vos essais dans le bac à sable. Pour une syntaxe complète, voir le site de référence.



Paragraphes

Les paragraphes sont séparés par une ligne vide.

Titres

Les titres sont soulignés par des signes égaux :

Titre
=====

Les sous-titres sont soulignés par des signes moins :

Sous-titre
----------

On peut aussi introduire les titres par un ou plusieurs dièses. On peut ainsi avoir les 6 niveaux de titre du HTML.

# Titre (niveau 1)

## Sous-titre (niveau 2)

### sous-titre de niveau 3

###### sous-titre de niveau 6

Mise en valeur

Pour mettre en valeur une partie du texte, il faut l'encadrer de _ ou de *. En doublant le nombre de marqueurs, on augmente la mise en valeur.

*Ceci* est _important_, et **cela** est très __important__.

Donnera :

Ceci est important, et cela est très important.

Listes

Chaque ligne d'une liste ordonnée commence par un nombre suivi d'un point.

1. Un
2. Deux
1. Trois

Donnera :

  1. Un
  2. Deux
  3. Trois

De même, chaque ligne d'une liste non-ordonnée commence par *, - ou +.

* étoile
+ plus
- moins

Donnera :

Séparations

Pour tracer une ligne, il faut au moins 3 -, _ ou *, seuls sur une ligne.

Code

Pour mettre du code au milieu d'un texte on l'encadre de `. Pour des paragraphes entiers de code, chaque ligne doit commencer par 4 espaces ou une tabulation.

Liens et images

Pour insérer un lien, il faut placer le texte du lien entre crochets, suivi de l'adresse entre parenthèse. Par exemple [IkiWiki](http://ikiwiki.info/) donnera : IkiWiki.

De même, pour insérer une image, on préfixe le tout par un point d'exclamation, suivi du texte alternatif entre crochet et de l'adresse de l'image entre parenthèse. Par exemple ![logo](http://ikiwiki.info/logo/ikiwiki.png) affichera logo.