Didier : Page créée avec « '''Markdown''' est un langage de balisage léger créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une syntaxe facile à lire et à écrire. Un... »

2014-06-21T13:05:53Z

Page créée avec « '''Markdown''' est un langage de balisage léger créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une syntaxe facile à lire et à écrire. Un... »

Nouvelle page

'''Markdown''' est un [[langage de balisage léger]] créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une [[syntaxe]] facile à lire et à écrire. 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.

Un document rédigé en Markdown peut être converti facilement en HTML. Bien que la syntaxe Markdown ait été influencée par plusieurs filtres de conversion de texte existants vers HTML — dont Setext<ref> [http://docutils.sourceforge.net/mirror/setext.html Setext]</ref>, atx<ref>[http://www.aaronsw.com/2002/atx/ atx]</ref>, [[Textile (langage)|Textile]], [[reStructuredText]], Grutatext<ref>[http://www.triptico.com/software/grutatxt.html Grutatext]</ref> et EtText<ref>[http://ettext.taint.org/doc/ EtText]</ref> —, la source d’inspiration principale est le format du [[courrier électronique]] en mode texte.

== Quelques exemples ==
Voici quelques exemples de syntaxe Markdown. Quelques balises HTML équivalentes sont données.

Cette liste n'est pas exhaustive.

=== Formatage ===

Pour mettre du texte en emphase (balise HTML <nowiki><em></nowiki>), ce qui produit une mise en italique dans un navigateur courant :
*quelques mots* ou _quelques mots_

Pour mettre du texte en grande emphase (balise HTML <nowiki><strong></nowiki>), ce qui produit une mise en gras dans un navigateur courant :
**plus important** ou __également important__

Pour mettre du code dans le texte (balise HTML <nowiki><code></nowiki>) :
Mon texte `code` fin de mon texte

Pour un paragraphe de code, mettre quatre espaces devant:
Première ligne de code
Deuxième ligne

Comme dans les courriels, il est possible de faire des citations :
> Ce texte apparaîtra dans un élément HTML <nowiki><blockquote></nowiki>.

Pour faire un nouveau paragraphe, sauter une ligne
Premier paragraphe

Deuxième paragraphe

Pour faire un simple retour à la ligne, mettre deux espaces en fin de ligne (balise HTML <nowiki><br></nowiki>).

=== Listes ===

Sauter une ligne avant le début de la liste.

Pour créer une liste non ordonnée (balise HTML <nowiki><ul></nowiki>) :
* Pommes
* Poires
* Sous élément avec au moins quatre espaces devant.

Et une liste ordonnée (balise HTML <nowiki><ol></nowiki>) :
1. mon premier
2. mon deuxième

=== Titres ===
Les titres sont créés avec un certain nombre de [[Croisillon (signe)|#]] avant le titre, qui correspondent au niveau de titre souhaité (le [[HTML]] propose 6 niveaux de titres de <nowiki><h1></nowiki> à <nowiki><h6></nowiki>)

# un titre de premier niveau
#### un titre de quatrième niveau

Pour les deux premiers niveaux de titre (<nowiki><h1></nowiki> et <nowiki><h2></nowiki>), il est également possible de souligner le titre avec des [[=]] ou des [[Tiret|-]] (leur nombre réel importe peu, mais il doit être supérieur à 2).

Titre de niveau 1
<nowiki>=====================</nowiki>

Titre de niveau 2
<nowiki>--------------------</nowiki>

=== Liens ===

Pour créer des liens (balise HTML <nowiki><a></nowiki>) :
[texte du lien](url_du_lien "texte pour le titre, facultatif")

=== Images ===

Pour afficher une image (balise HTML <nowiki><img></nowiki>) :
<nowiki> ![Texte alternatif](url_de_l'image "texte pour le titre, facultatif")</nowiki>

== Mises en œuvre ==

Plusieurs [[mise en œuvre|mises en œuvre]] existent et ce dans différents [[langages de programmation]] : en [[Perl (langage)|Perl]]<ref>[http://daringfireball.net/projects/markdown/ Perl (implémentation de référence)]</ref>, qui reste la mise en œuvre de référence, en [[PHP]]<ref>[http://www.michelf.com/projects/php-markdown/ PHP Markdown] (Markdown en PHP)</ref>, en [[Ruby]]<ref>[http://www.deveiate.org/projects/BlueCloth BlueCloth] (Markdown en Ruby)</ref>, en [[Python (langage)|Python]]<ref>[http://pypi.python.org/pypi/Markdown Markdown en Python]</ref>, en [[Java (langage)|Java]]<ref>[http://sourceforge.net/projects/markdownj/ markdownj] (Markdown en Java)</ref>, en [[C sharp|C#]]<ref>[http://www.aspnetresources.com/blog/markdown_announced.aspx Markdown.NET] (Markdown en C# et .NET)</ref>, en [[Haskell]]<ref>[http://johnmacfarlane.net/pandoc/ pandoc] (Markdown en Haskell)</ref>, et même en [[Javascript]]<ref>[https://github.com/coreyti/showdown/ showdown] (Markdown en Javascript)</ref>, notamment avec strapdown.js<ref>[http://strapdownjs.com/ strapdown.js]</ref>.

== Évolutions ==

Depuis sa création originelle par Gruber et Swartz, Markdown n'a pas connu d'évolution notoire de la part de ses auteurs. De plus, ce format n'a jamais été formellement standardisé.

Un certain nombre de variantes ont donc été développées par d'autres, afin de pallier ce qui a été perçu comme des limitations inhérentes à une syntaxe très simplifiée.

À titre d'exemples, on pourra citer [[MultiMarkdown]] et [[GitHub Flavored Markdown]]<ref>[https://help.github.com/articles/github-flavored-markdown "GitHub Flavored Markdown"]</ref>.
Ce dernier est utilisé pour les articles et la documentation sur [[Github]] lui-même, mais a également été largement adopté sur plusieurs [[Éditeur_de_texte|éditeurs de texte]] supportant le format Markdown au niveau de la [[coloration syntaxique]] ou de la prévisualisation.

Il existe également des greffons pour de nombreux logiciels populaires, tels que "Markdown Here" pour [[Firefox]] et [[Chrome (logiciel)|Chrome]], et le système de gestion de contenu [[WordPress]] intègre désormais ce langage nativement.

== Notes et références ==
<references />

== Liens externes ==

* http://daringfireball.net/projects/markdown/
* [http://www.michelf.com/projets/php-markdown/syntaxe/ Traduction en français de la syntaxe]
* [http://www.michelf.com/projets/php-markdown/banc-d'essai/ Tester la syntaxe]

[[Catégorie:Langage de balisage léger]]

Markdown - Historique des versions

Didier : Page créée avec « '''Markdown''' est un langage de balisage léger créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une syntaxe facile à lire et à écrire. Un... »

Didier : Page créée avec « '''Markdown''' est un langage de balisage léger créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une syntaxe facile à lire et à écrire. Un... »