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:

![Texte alternatif de l'image](https://chemin/vers/image.jpg)

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: