Markdown

Syntaxe Mardown  
===============

Principe
--------

La [syntaxe de Markdown] sert un objectif : être utilisée comme format d’écriture sur le web.  
Le principe: 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.  
Pour introduire des balises `<br>`, ajouter deux espaces en fin de ligne.  
Pour n’importe quelle fonction qui n’est pas couverte par la syntaxe de Markdown, vous utilisez directement une balise HTML. 
La version *Mardown Extra* de [PHP Markdown] n'est pas incluse par défaut (support de DL, TABLE, ABBR, notes, ancres).

Mais on peut réaliser des extensions soi-même: voir 
<https://github.com/coreyti/showdown/blob/master/README.md>

[syntaxe de Markdown]: http://daringfireball.net/projects/markdown/syntax
[PHP Markdown]: http://michelf.ca/projets/php-markdown/

Titres 
-------

Faire précéder de # un titre H1, de ## un titre H2, de ### un titre H3, etc...
On peut aussi souligner avec des = un titre H1 et avec des - un titre H2

Une ligne seule = `<HR>`

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

Listes
------

Avec *, - ou + comme marqueur de liste. Pour les listes numérotées:

1. premier
2. second
3. troisième

Emphase
-------

Entre * 
: *EM*

Entre ** 
: **STRONG**

Entre \` 
: `CODE`

Liens 
-----

le texte du [lien](http://audiovie.org/ "un super site") est entre crochets, l'URL entre parenthèses (suivi d'un "titre" éventuel entre "").
Pour liens internes, on peut définir des ancres par syntaxe `{#ancre}` suivant un titre ou un bloc de code

Les liens par référence utilisent une deuxième paire de crochets, avec une étiquette (numéro) pour identifier le lien :

Ceci est `[un exemple][1]` de [lien en référence][1].

Ensuite, n’importe où dans le document, vous définissez le lien de cette façon, sur sa propre ligne :

`[1]: http://exemple.com/  "Titre facultatif"`

Vous pouvez utiliser un nom de lien implicite, ce qui vous permet d’omettre le nom du lien, et dans ce cas le lien est identifié par son texte (qui peut contenir des espaces). 
Utilisez simplement une paire de crochets vides (optionnels) — c’est à dire que pour créer un lien « Audiovie » vers le site audiovie.org, vous pouvez simplement écrire :

`[Audiovie]`, et ensuite définir le lien [Audiovie]:

`[Audiovie]: http://audiovie.org/`

[1]: http://exemple.com/  "Titre facultatif"
[Audiovie]: http://audiovie.org/

Images
-------

On peut utiliser exactement les mêmes syntaxes pour les images que pour les liens avec un ! avant l'ouverture du crochet, le texte devient le texte alternatif (ALT). En cas d'utilisation de la syntaxe "par référence", les crochets pour la référence ne sont pas précédés du "!"

![Texte alternatif](http://audiovie.org/charte/logo.gif)

Liens automatiques
------------------

entourez tout simplement l’adresse par  < et >
<http://audiovie.org> et <adresse@exemple.com>

## Code HTML

Les <b>élements HTML</b> en-ligne sont traités sauf si entourés de apostrophe inversée: \`
(permet de faire du "inline")
`<b>exemple</b>`

ou dans un bloc indenté entouré de lignes vides (`<PRE>`):

<b>exemple</b>

Pour être interprétés les élément HTML représentant un bloc de texte ”c’est à dire  `<div>, <table>, <pre>, <p>`, etc.” doivent être séparés du contenu environnant par des lignes vides et ne doivent pas être indentés.

## Blockquote

Précédés par > comme dans mails. Imbrications possibles mais laisser ligne vide à chaque fois

> #### Ceci est un titre ####
> 
> 1.  Ceci est le premier élément d'une liste.
> 2.  Ceci est le second élément d'une liste.
> 
> Voici un exemple de code (indenté) :
> 
>     return shell_exec("echo $input | $markdown_script");
>
> > Ceci est un bloc de citation imbriqué.
>

## Caractères spéciaux

en particulier pour * : l'entourer d'espaces ou la faire précéder de `\`

showdown.js -- A javascript port of Markdown.

Original Markdown Copyright (c) 2004-2005 John Gruber
http://daringfireball.net/projects/markdown/

The full source distribution is at: http://www.attacklab.net/