Markdown

Caractéristiques
Extensions	.md, .markdown, .mkd, .mdown, .mdtxt, .mdtext
Type MIME	text/markdown
PUID	fmt/1149
Développé par	Aaron Swartz, John Gruber
Version initiale	19 mars 2004
Type de format	Langage de balisage
Spécification	Format ouvert
Site web	(en) daringfireball.net/projects/markdown

Markdown est un langage de balisage léger créé en 2004 par John Gruber, avec l'aide d'Aaron Swartz^[1]^,^[2], avec l'objectif d'offrir une syntaxe, facile à lire et à écrire, en l'état, sans formatage.

Markdown est principalement utilisé dans des blogs, des sites de messagerie instantanée, des forums et des pages de documentation de logiciels. Depuis quelques années, Markdown est utilisé par la communauté scientifique^[3]^,^[4]^,^[5], en lien avec la Science ouverte^[6].

Un document balisé par Markdown peut être converti en HTML, en PDF ou en d'autres formats. Bien que la syntaxe Markdown ait été influencée par plusieurs filtres de conversion de texte existants vers HTML — dont Setext^[7], atx^[8], Textile, reStructuredText, Grutatext^[9] et EtText^[10] —, la source d’inspiration principale du Markdown est le format du courrier électronique en mode texte^[11].

Évolutions

Markdown n'a jamais été formellement standardisé, diverses variantes ont été développées par des tiers afin de pallier ce qui était perçu comme des limitations du langage originel. Parmi ces variantes, figurent notamment MultiMarkdown^[12] et GitHub Flavored Markdown^[13]. Ce dernier est utilisé pour les articles et la documentation sur GitHub, mais a également été largement adopté sur plusieurs é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, tels que « Markdown Here » pour Firefox et Chrome. Le système de gestion de contenu WordPress intègre dans sa forme initiale quelques éléments de ce langage depuis la version 4.3.

En mars 2016, dans le but de standardiser le langage, deux RFC ont été publiées :

RFC 7763^[14], qui introduit le type MIME text/markdown à partir de la variante originale de Markdown.
RFC 7764^[15], qui répertorie des variantes MultiMarkdown, GitHub Flavored Markdown (GFM), Pandoc, CommonMark, Markdown Extra et autres^[16].

L'initiative CommonMark, débutée en 2012, vise à pallier le manque de standardisation et les ambiguïtés du format en créant une spécification fortement définie du langage. Elle est désormais utilisée par, entre autres, Discourse, GitLab, Reddit, Qt, Stack Overflow et Stack Exchange^[17].

Mises en œuvre

Plusieurs mises en œuvre existent dans différents langages de programmation tels qu'en Perl^[18], en PHP^[19], en Ruby^[20], en Python^[21], en Java^[22], en C#^[23], en Haskell^[24], en Gambas, en R^[25], ou en JavaScript^[26]^,^[27]^,^[28]^,^[29]^,^[30]. Depuis la version 2.0 de Swift, il est aussi possible d'utiliser le Markdown dans ses playgrounds.

Utilisations

Le langage de balisage léger Markdown est utilisé dans de nombreuses applications, que ce soit dans des logiciels/éditeurs de code^[31], des logiciels d'écriture^[32], des plateformes de code^[33]^,^[34], ou encore dans des chaînes d'édition^[35] avec l'addition d'autres logiciels. Les domaines d'application incluent le développement informatique (Markdown est fréquemment utilisé pour formater le fichier README décrivant le code source d'un programme), la rédaction de documentation technique ou encore la publication académique^[36].

C’est aussi le langage de balisage choisi par de nombreuses plateformes d’écriture collaborative, comme Authorea, Manubot^[37] ou Stylo^[38]. Il existe plusieurs logiciels permettant de rédiger en Markdown en temps réel sur le web, comme HedgeDoc, Etherpad ou Firepad.

Exemples de la syntaxe

Le tableau, ci-dessous, présente des exemples de syntaxe Markdown, avec les balises HTML équivalentes.

Texte utilisant la syntaxe Markdown HTML produit par un processeur Markdown Texte vu à travers un navigateur

Titre
=======

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

# Titre alternatif

## Sous-titre alternatif

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

Deux espaces à la fin d'une ligne  
produisent un saut de ligne.

<h1>Titre</h1>

<h2>Sous-titre</h2>

<h1>Titre alternatif</h1>

<h2>sous-titre alternatif</h2>

<p>Les paragraphes sont séparés
par une ligne vide.</p>

<p>Deux espaces à la fin d'une ligne<br />
 produisent un saut de ligne.</p>

Titre

Sous-titre

Titre alternatif

Sous-titre alternatif

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

Deux espaces à la fin d'une ligne
produisent un saut de ligne.

Les caractères _italiques_, **gras**, `à taille fixe`.

Filet:

---

<p>Les caractères <em>italiques</em>, <strong>gras</strong>, <code>à taille fixe</code>.</p>

<p>Filet:</p>

<hr />

Les caractères italiques, en gras, à taille fixe.

Filet:

Liste à puces imbriquée dans une liste ordonnée:

  1. fruits
     * pomme
     * banane
  2. légumes
     - carotte
     - brocoli

Liste à cocher:
 - [ ] Case non cochée
 - [x] Case cochée

<p>Liste à puces imbriquée dans une liste ordonnée:</p>

<ol>
  <li>fruits <ul>
      <li>pomme</li>
      <li>banane</li>
  </ul></li>
  <li>légumes <ul>
      <li>carotte</li>
      <li>brocoli</li>
  </ul></li>
</ol>
<p>Liste à cocher:</p>
<ul>
<li><input type="checkbox" id="" disabled="" >Case non cochée </li>
<li><input type="checkbox" id="" disabled="" > Case cochée</li>
</ul>

Liste à puces imbriquée dans une liste numérotée :

fruits
- pomme
- banane
légumes
- carottes
- brocoli

Liste à cocher :

Case non cochée
Case cochée

Un [lien](http://example.com).

![Image](Icon-pictures.png "icon")

> Markdown utilise les caractères à la manière des emails pour faire des citations en bloc.
>
> Chaque paragraphe doit être précédé par ce caractère.

La plupart des balises <abbr title="Hypertext Markup Language">HTML</abbr> de type « en ligne » sont prises en compte.

<p>Un <a href="http://example.com">lien</a>.</p>

<p><img alt="Image" title="icon" src="Icon-pictures.png" /></p>

<blockquote>
<p>Markdown utilise les caractères à la manière des emails pour afficher des citations en bloc.</p>
<p>Chaque paragraphe doit être précédé par ce caractère.</p>
</blockquote>

<p>La plupart des balises <abbr title="Hypertext Markup Language">HTML</abbr> de type « en ligne » sont prises en compte.</p>

Un lien.

Markdown utilise les caractères à la manière des emails pour afficher des citations en bloc.
Chaque paragraphe doit être précédé par ce caractère.

La plupart des balises HTML de type « en ligne » sont prises en compte.

| Titre 1       |     Titre 2     |        Titre 3 |
| :------------ | :-------------: | -------------: |
| Colonne       |     Colonne     |        Colonne |
| Alignée à     |   Alignée au    |      Alignée à |
| Gauche        |     Centre      |         Droite |

(NOTE : la justification à gauche, au centre ou à droite se fait via la présence ou l'absence des deux points : sur la ligne horizontale)

<table>
 <thead>
   <tr>
    <th align="left">Titre 1</th>
    <th align="center">Titre 2</th>
    <th align="right">Titre 3</th>
 </tr>
</thead>
<tbody>
  <tr>
   <td align="left">Colonne</td>
   <td align="center">Colonne</td>
   <td align="right">Colonne</td>
 </tr>
 <tr>
  <td align="left">Alignée à</td>
  <td align="center">Alignée au</td>
  <td align="right">Alignée à</td>
 </tr>
 <tr>
  <td align="left">Gauche</td>
  <td align="center">Centre</td>
  <td align="right">Droite</td>
 </tr>
</tbody>
</table>

Titre 1	Titre 2	Titre 3
Colonne	Colonne	Colonne
Alignée à	Alignée au	Alignée à
Gauche	Centre	Droite

Annexes

Articles connexes

Liens externes

(en) Site officiel

Références

↑ « Markdown ».
↑ « Markdown » (version du 2 avril 2004 sur Internet Archive).
↑ Ined, « La Science ouverte à l'Ined », sur so.site.ined.fr (consulté le 18 juillet 2024).
↑ Arthur Perret, « Lodel 2, Stylo 2 : le Markdown scientifique entre dans une nouvelle ère » , sur arthurperret.fr, 30 avril 2024 (consulté le 18 juillet 2024).
↑ La science ouverte à INRAE, « Recommandations », sur science-ouverte.inrae.fr (consulté le 18 juillet 2024).
↑ Bernard Pochet, Markdown & vous, Liège, ULiège Library, 2023 (ISBN 978-2-87019-318-1, lire en ligne)
↑ Setext.
↑ atx.
↑ Grutatext.
↑ EtText.
↑ « Daring Fireball: Markdown Syntax Documentation », sur daringfireball.net (consulté le 24 septembre 2020).
↑ « MultiMarkdown », sur fletcherpenney.net (consulté le 22 septembre 2020).
↑ (en) « GitHub Flavored Markdown ».
↑ (en) « The text/markdown Media Type », sur tools.ietf.org (consulté le 23 octobre 2020).
↑ (en) « Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations », sur tools.ietf.org (consulté le 23 octobre 2020).
↑ « Markdown Variants », sur iana.org (consulté le 25 septembre 2020).
↑ (en) « Common Mark », sur commonmark.org.
↑ Perl (implémentation de référence).
↑ PHP Markdown (Markdown en PHP).
↑ BlueCloth (Markdown en Ruby).
↑ Markdown en Python.
↑ markdownj (Markdown en Java).
↑ Markdown.NET (Markdown en C# et .NET).
↑ pandoc (Markdown en Haskell).
↑ (en) R Markdown.
↑ (en) « micromark » (consulté le 14 février 2024).
↑ (en) « remark » (consulté le 14 février 2024).
↑ (en) « zmarkdown » (consulté le 14 février 2024).
↑ (en) « showdown » (consulté le 14 février 2024).
↑ (en) « StrapDown.js » (consulté le 14 février 2024).
↑ (en) « The 10 Best Markdown Editors of 2018 – Shopify », sur Web Design and Development Blog | Web Design Trends, Tips, and More by Shopify Partners. (consulté le 21 octobre 2019).
↑ Marcello Vitali-Rosati, « Stylo : un éditeur de texte pour les sciences humaines et sociales », sur Culture numérique, 3 juin 2018 (consulté le 21 octobre 2019).
↑ « Mastering Markdown · GitHub Guides », sur guides.github.com (consulté le 21 octobre 2019).
↑ (en) « Markdown Guide », sur GitLab (consulté le 21 octobre 2019).
↑ (en-US) « Interview with Eric Gardner, Getty Publications », sur the New Dynamic, 26 janvier 2017 (consulté le 21 octobre 2019).
↑ Collectif, « Markdown et Zotero », sur Le blog Zotero francophone (consulté le 21 octobre 2019).
↑ (en) Jeffrey M. Perkel, « Synchronized editing: the future of collaborative writing », Nature, vol. 580, n^o 7801,‎ 31 mars 2020, p. 154–155 (DOI 10.1038/d41586-020-00916-6, lire en ligne, consulté le 12 septembre 2020).
↑ Stylo, « Documentation », sur stylo-doc.ecrituresnumeriques.ca (consulté le 18 juillet 2024).

Portail de l’informatique

[1] « Markdown ».

[2] « Markdown » (version du 2 avril 2004 sur Internet Archive).

[3] Ined, « La Science ouverte à l'Ined », sur so.site.ined.fr (consulté le 18 juillet 2024).

[4] Arthur Perret, « Lodel 2, Stylo 2 : le Markdown scientifique entre dans une nouvelle ère » , sur arthurperret.fr, 30 avril 2024 (consulté le 18 juillet 2024).

[5] La science ouverte à INRAE, « Recommandations », sur science-ouverte.inrae.fr (consulté le 18 juillet 2024).

[6] Bernard Pochet, Markdown & vous, Liège, ULiège Library, 2023 (ISBN 978-2-87019-318-1, lire en ligne)

[7] Setext.

[8] tx.

[9] Grutatext.

[10] EtText.

[11] « Daring Fireball: Markdown Syntax Documentation », sur daringfireball.net (consulté le 24 septembre 2020).

[12] « MultiMarkdown », sur fletcherpenney.net (consulté le 22 septembre 2020).

[13] (en) « GitHub Flavored Markdown ».

[14] (en) « The text/markdown Media Type », sur tools.ietf.org (consulté le 23 octobre 2020).

[15] (en) « Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations », sur tools.ietf.org (consulté le 23 octobre 2020).

[16] « Markdown Variants », sur iana.org (consulté le 25 septembre 2020).

[17] (en) « Common Mark », sur commonmark.org.

[18] Perl (implémentation de référence).

[19] PHP Markdown (Markdown en PHP).

[20] BlueCloth (Markdown en Ruby).

[21] Markdown en Python.

[22] rkdownj (Markdown en Java).

[23] Markdown.NET (Markdown en C# et .NET).

[24] (Markdown en Haskell).

[25] (en) R Markdown.

[26] (en) « micromark » (consulté le 14 février 2024).

[27] (en) « remark » (consulté le 14 février 2024).

[28] (en) « zmarkdown » (consulté le 14 février 2024).

[29] (en) « showdown » (consulté le 14 février 2024).

[30] (en) « StrapDown.js » (consulté le 14 février 2024).

[31] (en) « The 10 Best Markdown Editors of 2018 – Shopify », sur Web Design and Development Blog | Web Design Trends, Tips, and More by Shopify Partners. (consulté le 21 octobre 2019).

[32] Marcello Vitali-Rosati, « Stylo : un éditeur de texte pour les sciences humaines et sociales », sur Culture numérique, 3 juin 2018 (consulté le 21 octobre 2019).

[33] « Mastering Markdown · GitHub Guides », sur guides.github.com (consulté le 21 octobre 2019).

[34] (en) « Markdown Guide », sur GitLab (consulté le 21 octobre 2019).

[35] (en-US) « Interview with Eric Gardner, Getty Publications », sur the New Dynamic, 26 janvier 2017 (consulté le 21 octobre 2019).

[36] Collectif, « Markdown et Zotero », sur Le blog Zotero francophone (consulté le 21 octobre 2019).

[37] (en) Jeffrey M. Perkel, « Synchronized editing: the future of collaborative writing », Nature, vol. 580, n^o 7801,‎ 31 mars 2020, p. 154–155 (DOI 10.1038/d41586-020-00916-6, lire en ligne, consulté le 12 septembre 2020).

[38] Stylo, « Documentation », sur stylo-doc.ecrituresnumeriques.ca (consulté le 18 juillet 2024).

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

[14]

[15]

[16]

[17]

[18]

[19]

[20]

[21]

[22]

[23]

[24]

[25]

[26]

[27]

[28]

[29]

[30]

[31]

[32]

[33]

[34]

[35]

[36]

[37]

[38]

Extensions	`.md`, `.markdown`, `.mkd`, `.mdown`, `.mdtxt`, `.mdtext`
Type MIME	`text/markdown`
PUID	fmt/1149
Développé par	Aaron Swartz, John Gruber
Version initiale	19 mars 2004
Type de format	Langage de balisage
Spécification	Format ouvert
Site web	(en) daringfireball.net/projects/markdown