Paragraphe

Balise HTML : <p>

Séparez les paragraphes par une ou plusieurs lignes vides. (Une ligne ne contenant que des espaces ou des tabulations est également considérée comme vide.)

Code :

1
This will be
2
inline.
3

4
This is second paragraph.

Aperçu :

This will be inline.

This is second paragraph.

Saut de ligne

Balise HTML : <br />

Ajoutez deux espaces ou plus en fin de ligne pour produire un saut de ligne.

Code :

1
This will be not
2
inline.

Aperçu :

This will be not
inline.

Setext

Balises HTML : <h1>, <h2>

Utilisez des signes égal (=) pour <h1> et des tirets (-) pour <h2>, en nombre quelconque, en guise de « soulignement ».

Code :

1
This is an H1
2
=============
3
This is an H2
4
-------------

Aperçu :

atx

Balises HTML : <h1>, <h2>, <h3>, <h4>, <h5>, <h6>

Placez 1 à 6 dièses (#) en début de ligne pour correspondre respectivement à <h1> jusqu’à <h6>.

Code :

1
# This is an H1
2
## This is an H2
3
###### This is an H6

Aperçu :

This is an H6

Optionnel : vous pouvez « fermer » un titre atx en fin de ligne. Le nombre de dièses de fermeture n’a pas besoin de correspondre à celui d’ouverture.

Code :

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

Aperçu :

This is an H3

Citations

Balise HTML : <blockquote>

Markdown utilise le caractère > à la manière des citations de courrier électronique. Pour un rendu optimal, ajoutez manuellement un retour à la ligne et faites précéder chaque ligne d’un >.

Code :

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

Aperçu :

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown autorise la version « paresseuse » : dans un paragraphe avec retours à la ligne manuels, seule la première ligne doit être précédée d’un >.

Code :

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

Aperçu :

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Les citations peuvent être imbriquées (citation dans une citation) en augmentant le niveau de >.

Code :

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

Aperçu :

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

Une citation peut contenir d’autres éléments Markdown, notamment des titres, des listes et des blocs de code.

Code :

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

Aperçu :

This is a header.

1. This is the first list item.
2. This is the second list item.

Here’s some example code:

1
return shell_exec("echo $input | $markdown_script");

Listes

Markdown supporte les listes ordonnées (numérotées) et non ordonnées (à puces).

1
*   Red
2
*   Green
3
*   Blue

1
+   Red
2
+   Green
3
+   Blue

1
-   Red
2
-   Green
3
-   Blue

1
1.  Bird
2
2.  McHale
3
3.  Parish

1
1986. What a great season.

1
1986\. What a great season.

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

1
*   A list item with a code block:
2

3
        <code goes here>

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

Blocs de code

Balise HTML : <pre>

Indentez chaque ligne du bloc de code d’au moins 4 espaces ou 1 tabulation.

Code :

1
This is a normal paragraph:
2

3
    This is a code block.

Aperçu :

This is a normal paragraph:

1
This is a code block.

Un bloc de code continue jusqu’à la première ligne non indentée (ou la fin du document).

À l’intérieur d’un bloc de code, l’esperluette (&) et les chevrons (< >) sont automatiquement convertis en entités HTML.

Code :

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

Aperçu :

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

Les « Blocs de code clôturés » et la « Coloration syntaxique » présentés ci-dessous sont des syntaxes étendues que vous pouvez également utiliser pour écrire des blocs de code.

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

Ligne horizontale

Balise HTML : <hr /> Placez trois tirets (-), astérisques (*) ou underscores (_) ou plus sur une même ligne. Des espaces entre les symboles sont autorisés.

Code :

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

Aperçu :

Tableaux

Balise HTML : <table>

Il s’agit d’une syntaxe étendue.

Séparez les colonnes avec des barres verticales (|) et l’en-tête avec des tirets (-). Utilisez les deux-points (:) pour spécifier l’alignement.

Les barres verticales (|) encadrantes et l’alignement sont optionnels. Pour la séparation d’en-tête, chaque colonne nécessite au moins 3 tirets.

Code :

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

Aperçu :

Liens

Balise HTML : <a>

Markdown supporte deux styles de liens : le lien en ligne et le lien de référence.

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

1
See my [About](/about/) page for details.

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

1
[Google]: http://google.com/
2
[Google][]

Emphase

Balises HTML : <em>, <strong>

Markdown utilise l’astérisque (*) ou l’underscore (_) pour l’emphase. Un délimiteur correspond à <em> ; deux délimiteurs correspondent à <strong>.

Code :

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

Aperçu :

single asterisks

single underscores

double asterisks

double underscores

Cependant, si les délimiteurs sont entourés d’espaces, ils sont traités comme des caractères ordinaires et non comme de la syntaxe d’emphase.

Vous pouvez utiliser l’antislash pour les échapper :

Code :

1
\*this text is surrounded by literal asterisks\*

Aperçu :

*this text is surrounded by literal asterisks*

Code en ligne

Balise HTML : <code>

Entourez le code de backticks (`).

Code :

1
Use the `printf()` function.

Aperçu :

Use the printf() function.

Si le code en ligne doit contenir un backtick, utilisez des backticks multiples comme délimiteurs :

Code :

1
``There is a literal backtick (`) here.``

Aperçu :

There is a literal backtick (`) here.

Les délimiteurs d’un code en ligne peuvent inclure des espaces de chaque côté (un en début, un en fin), ce qui facilite l’insertion d’un backtick en début ou en fin de code :

Code :

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

Aperçu :

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

Images

Balise HTML : <img />

La syntaxe des images en Markdown est similaire à celle des liens, et supporte les formes en ligne et de référence.

Image en ligne

Syntaxe de l’image en ligne : ![texte alternatif](URL "titre")

Le titre est optionnel.

Code :

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

Aperçu :

---

---

Remarques :

• Un point d’exclamation ! ;
• suivi de crochets contenant le texte alternatif de l’image ;
• suivi de parenthèses contenant l’URL ou le chemin de l’image, ainsi qu’un titre optionnel (entre guillemets).

Image de référence

Syntaxe de l’image de référence : ![texte alternatif][id]

Code :

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

Aperçu :

---

---

Texte barré

Balise HTML : <del>

Il s’agit d’une syntaxe étendue.

GFM ajoute la syntaxe du texte barré.

Code :

1
~~Mistaken text.~~

Aperçu :

Mistaken text.

Lien automatique

Markdown supporte une syntaxe raccourcie pour créer des « liens automatiques » (URL et adresses e-mail) : il suffit de les entourer de chevrons.

Code :

1
<http://example.com/>
2

3
<address@example.com>

Aperçu :

http://example.com/

address@example.com

GFM reconnaît automatiquement les URL standard et les convertit en liens.

Code :

1
https://github.com/emn178/markdown

Aperçu :

https://github.com/emn178/markdown

Échappement par antislash

Markdown vous permet d’utiliser l’antislash pour échapper les caractères spéciaux utilisés dans la syntaxe Markdown, afin qu’ils s’affichent littéralement.

Code :

1
\*literal asterisks\*

Aperçu :

*literal asterisks*

Les caractères suivants peuvent être échappés par un antislash pour être affichés littéralement :

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark