Le Markdown est un langage de balisage léger créé par John Gruber permettant d'écrire des blogs, de la documentation, des livres, etc. dans un format simple et convivial. Le Markdown peut ensuite être converti facilement en divers formats, notamment: Word, PDF, EPUB ou encore HTML.
Sa grande force réside dans sa simplicité permettant de se concentrer sur l'écriture du texte lui-même, tout en offrant des options de mise en page de base.
Titres
# Titre 1
## Titre 2
### Titre 3
#### Titre 4
Générerait le code suivant:
<h1>Titre 1</h1>
<h2>Titre 2</h2>
<h3>Titre 3</h3>
<h4>Titre 4</h4>
Emphases
**Gras** ou __Gras__
*Italique* ou _Italique_
~~Barré~~
Générerait le code suivant:
<strong>Gras</strong> ou <strong>Gras</strong>
<em>Italique</em> ou <em>Italique</em>
<del>Barré</del>
Paragraphes
En Markdown, chaque bloc de texte devient un paragraphe. Ainsi, pour séparer deux paragraphes, il suffit de laisser une ligne vide entre ceux-ci.
Par exemple:
Lorem ipsum dolor sit amet,
consectetur adipiscing elit.
Maecenas cursus tristique diam
Généreraient les deux paragraphes suivant:
<p>Lorem ipsum dolor sit amet,<br>
consectetur adipiscing elit.</p>
<p>Maecenas cursus tristique diam</p>
Liens
[Texte à afficher](https://site.com)
Générerait le code suivant:
<a href="https://site.com">Texte à afficher</a>
Images
Les images ressemblent énormément au lien à la différence prêt qu'un !
doit-être ajouté au début.
Par exemple:

Générerait le code suivant:
<img src="https://chemin/vers/image.jpg" alt="Texte alternatif de l'image">
Listes
À puce
Pour générer une simple liste à puces, il est possible de préfixer chaque item de la liste par le symbole -
.
Par exemple:
- Item 1
- Item 2
- Item 3
Générerait le code suivant:
<ul>
<li>Item 1</li>
<li>Item 2</li>
<li>Item 3</li>
</ul>
Ordonnée
Pour générer une liste ordonnée, il faut plutôt indiquer le numéro de chaque item suivi d'un .
.
Par exemple:
1. Item 1
2. Item 2
3. Item 3
Générerait le code suivant:
<ol>
<li>Item 1</li>
<li>Item 2</li>
<li>Item 3</li>
</ol>
Blocs de citation
Pour afficher un bloc de citation, il suffit de préfixer la citation par le symbole >
.
Par exemple:
> Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Générerait le code suivant:
<blockquote>
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
</blockquote>
Extrait de code
Les extraits de code doivent-être contenu entre backtick `...`
.
Par exemple:
`console.log('Lorem ipsum')`
Générerait le code suivant:
<pre>console.log('Lorem ipsum')<pre>
Utilisation
Mardown est entre autres utilisé sur les plateformes suivantes: