Markdown 📖 Wikipedia

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 (GFM)^[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. Le « dialecte »^[14] GitHub Flavored du Markdown s’appuie sur la spécification CommonMark^[15], à laquelle il est conforme et dont il est un dérivé (fork)^[16]. La version actuelle 0.29 de GFM, parue le 6 avril 2019, est décrite par John MacFarlane sous licence Creative Commons^[14].

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^[17], qui introduit le type MIME text/markdown à partir de la variante originale de Markdown.
• RFC 7764^[18], qui répertorie des variantes MultiMarkdown, GitHub Flavored Markdown (GFM), Pandoc, CommonMark, Markdown Extra et autres^[19].

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, Codeberg, Discourse, GitLab, Reddit, Qt, Stack Overflow et Stack Exchange^[20].

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

Le langage de balisage léger Markdown est utilisé dans de nombreuses applications, que ce soit dans des logiciels/éditeurs de code^[34], des logiciels d'écriture^[35], des plateformes de code^[36],[37], ou encore dans des chaînes d'édition^[38] 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^[39].

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

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

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>

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 />

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="" checked >Case cochée</li>
</ul>

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>

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

<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>

• (en) Site officiel

• Cet article est partiellement ou en totalité issu de l'article intitulé « GitHub Flavored Markdown » (voir la liste des auteurs).

•   Portail de l’informatique