Markdown dans les commentaires

Ce site propose de poster des commentaires dans un format proche du Markdown standard avec quelques altérations : pas de HTML brut, ni de titres, mais avec des tables. Voici en détail le format accepté, suivi d'un exemple.

Les éléments de texte

Le texte normal est entré simplement, et les tags HTML sont présentés comme du texte brut.

Des mots ou des parties de mot peuvent être mises en italique en les encadrant avec une étoile (*) ou un souligné (_).

De même en gras en les encadrant de deux de ces symboles, ou en gras italique en les encadrant de trois.

Des mots our des parties de mot peuvent êtres marquées comme un ajout en en les encadrant de deux plus (++), une suppression avec deux moins (--), ou un spoiler avec deux pourcents (%%). Les spoilers sont affichés de la même couleur que le fond pour n'être lisibles qu'en les sélectionnant. Dans les flux ATOM, comme il n'y a pas de CSS, ils sont encodés en ROT13 à la place.

Notez que tous ces éléments sont limités à l'intérieur d'un seul paragraphe, donc pour marquer l'ajout, la suppression, ou le divulgâchis de plusieurs paragraphes consécutifs, il faut mettre le marqueur au début et à la fin de chaque paragraphe.

Le code peut être entré en l'encadrant d'accents graves (`).

Les adresses web peuvent être rendues actives en les encadrant avec des symboles inférieur et supérieur (par exemple <http://instinctive.eu/>).

Des liens peuvent entrés en mettant le texte du lien entre crochets, puis immédiatement l'adresse, suivie d'un titre facultatif, entre parenthèses.

Une image est entrée de la même façon qu'un lien, avec un point d'exclamation devant.

Pour ceux qui connaissent, les syntaxes de liens par référence fonctionnent aussi, mais ne sont pas d'un grand intérêt dans un commentaire.

Voici un exemple de paragraphe contenant tous ces éléments :

Texte normal, _italique_, **gras**, ***italique et gras***,
++ajouté++, --supprimé--, %%divulgâchant%% et `code`.
<http://instinctive.eu/> est un lien vers [mon site](http://instinctive.eu/ "Instictive").
Et voici le papillon de gauche ![papillon](//instinctive.eu/images/butterfly1.png).
<script>alert(0);</script>

Voici le rendu :

Texte normal, italique, gras, italique et gras, ajouté, supprimé, divulgâchant et code. <http://instinctive.eu/> est un lien vers mon site. Et voici le papillon de gauche . <script>alert(0);</script>

Les blocs de texte

Les différents blocs de texte sont délimités par des lignes vides.

Les paragraphes, qui sont les blocs de base, n'ont pas de distinction particulière.

Les listes à puces sont présentées en mettant un symbole plus (+), tiret (-) ou étoile (*) devant chaque élément.

Les listes numérotées sont présentées avec n'importe quel nombre suivi d'un point et d'une espace (. ) avant chaque élément. La valeur du nombre n'est pas prise en compte, le premier élément est toujours affiché 1., le deuxième 2. , etc.

Les citations sont faites en reprenant les blocs à citer et en préfixant chaque ligne d'un signe supérieur suivi d'une espace (> ).

Les blocs de code sont présentés soit en préfixant chaque ligne de 4 espaces, soit en ajoutant avant et après le bloc au moins 4 symboles tilde (~~~~).

Voici un exemple utilisant tous ces éléments :

Ceci est un paragraphe normal.

> Ceci est une citation qui contient les deux exemples de listes :
>
> * Premier élément
> * Deuxième élément
>
> 4. Numéro un
> 2. Numéro deux
> 10. Numéro trois

~~~~
voici du code
~~~~

Paragraphe normal

    encore du code

Paragraphe normal à la fin

Voici le résultat :

Ceci est un paragraphe normal.

Ceci est une citation qui contient les deux exemples de listes :

• Premier élément
• Deuxième élément

1. Numéro un
2. Numéro deux
3. Numéro trois

voici du code

Paragraphe normal

encore du code

Paragraphe normal à la fin