Markdown is a lightweight markup language that lets you format plain text — headings, lists, links, emphasis — using simple, readable symbols. It is widely used for READMEs, documentation, and notes.

How do I write a code block in Markdown?

Wrap code in triple backticks (```) on their own lines, optionally adding a language name after the opening fence for syntax highlighting.

Does Markdown work the same everywhere?

Core syntax is consistent, but flavors differ. GitHub Flavored Markdown adds tables, task lists, and strikethrough on top of standard Markdown.

CHEAT SHEET

Markdown Guide

Everything you need to write Markdown: each piece of syntax is shown with its source on the left and its rendered result on the right.

Headings

Six heading levels, from largest to smallest, using the # character.

Markdown

# Titre 1
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6

Result

Titre 1

Titre 2

Titre 3

Titre 4

Titre 5

Titre 6

Markdown

Titre 1 (syntaxe alternative)
===

Titre 2 (syntaxe alternative)
---

Result

Titre 1 (syntaxe alternative)

Titre 2 (syntaxe alternative)

Paragraphs

Separate paragraphs with a blank line and force a line break when needed.

Markdown

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Result

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Markdown

Terminez une ligne par deux espaces␣␣
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse\
en fin de ligne.

Result

Terminez une ligne par deux espaces
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse
en fin de ligne.

Emphasis

Make text bold, italic or strikethrough.

Markdown

*italique* ou _italique_
**gras** ou __gras__
***gras et italique***
~~barré~~

Result

italique ou italique
gras ou gras
gras et italique
~~barré~~

Blockquotes

Quote text over one or more lines, and nest quotes inside each other.

Markdown

> Une citation simple.
>
> Sur plusieurs lignes.

Result

Une citation simple.
Sur plusieurs lignes.

Markdown

> Citation
>> Citation imbriquée
>>> Encore plus profond

Result

Citation
Citation imbriquée
Encore plus profond

Lists

Bulleted, numbered, nested and task lists.

Markdown

- Premier élément
- Deuxième élément
- Troisième élément

* Fonctionne aussi avec *
+ ou avec +

Result

Premier élément
Deuxième élément
Troisième élément

Fonctionne aussi avec *
ou avec +

Markdown

1. Premier
2. Deuxième
3. Troisième

Result

Premier
Deuxième
Troisième

Markdown

- Élément parent
  - Sous-élément
    - Sous-sous-élément
- Retour au parent

Result

Élément parent
- Sous-élément
  - Sous-sous-élément
Retour au parent

Markdown

- [x] Tâche terminée
- [ ] Tâche à faire
- [ ] Autre tâche

Result

Tâche terminée
Tâche à faire
Autre tâche

Code

Inline code, code blocks and language syntax highlighting.

Markdown

Utilisez `code en ligne` dans une phrase.

Result

Utilisez code en ligne dans une phrase.

Markdown

```
Bloc de code sans coloration
sur plusieurs lignes
```

Result

Bloc de code sans coloration
sur plusieurs lignes

Markdown

```js
function salut(nom) {
  return `Bonjour ${nom}`;
}
```

Result

function salut(nom) {
  return `Bonjour ${nom}`;
}

Links

Plain links, links with a title, autolinks or reference links.

Markdown

[Texte du lien](https://exemple.com)
[Avec une infobulle](https://exemple.com "Titre au survol")

Result

Texte du lien
Avec une infobulle

Markdown

Lien automatique : <https://exemple.com>

Lien de référence : [le texte][1]

[1]: https://exemple.com

Result

Lien automatique : https://exemple.com

Lien de référence : le texte

Images

Insert images with alt text, a title or a clickable link.

Markdown

![Texte alternatif](image.png)
![Avec titre](image.png "Titre au survol")

Result

Markdown

Une image cliquable :

[![Alt](image.png)](https://exemple.com)

Result

Une image cliquable :

Tables

Build tables and align columns left, center or right.

Markdown

| Nom   | Rôle      | Score |
| ----- | --------- | ----- |
| Alice | Admin     | 95    |
| Bob   | Éditeur   | 82    |

Result

Nom	Rôle	Score
Alice	Admin	95
Bob	Éditeur	82

Markdown

| Gauche | Centré | Droite |
| :----- | :----: | -----: |
| a      |   b    |      c |
| dd     |   ee   |     ff |

Result

Gauche	Centré	Droite
a	b	c
dd	ee	ff

Horizontal rules

Separate sections with a horizontal line.

Markdown

Trois tirets, astérisques ou underscores :

---

***

___

Result

Trois tirets, astérisques ou underscores :

Escaping

Show special characters literally instead of having them interpreted.

Markdown

\*Ceci n'est pas en italique\*
\# Ceci n'est pas un titre
\[Ceci n'est pas un lien\]

Result

*Ceci n'est pas en italique*
# Ceci n'est pas un titre
[Ceci n'est pas un lien]

Extended Markdown

Footnotes, emoji and inline HTML (depending on the engine).

Markdown

Voici une note de bas de page.[^1]

[^1]: Le contenu de la note.

Result

Voici une note de bas de page.¹

Le contenu de la note. ↩

Markdown

Émoji par code : :tada: :rocket: :+1:

Émoji direct : 🎉 🚀 👍

Result

Émoji par code : 🎉 🚀 👍

Émoji direct : 🎉 🚀 👍

Markdown

On peut aussi insérer du <mark>HTML</mark>
directement : <kbd>Ctrl</kbd> + <kbd>C</kbd>.

Result

On peut aussi insérer du HTML directement : Ctrl + C.

Markdown is a standard, but some elements (tables, checkboxes, footnotes, emoji) depend on the rendering engine you use.

About this Markdown Guide

A clear, example-driven Markdown cheat sheet covering the syntax you use every day: headings, bold and italic, lists, links, images, tables, code blocks, blockquotes, and more. Each example shows the Markdown source next to its rendered output.

FAQ

What is Markdown?: Markdown is a lightweight markup language that lets you format plain text — headings, lists, links, emphasis — using simple, readable symbols. It is widely used for READMEs, documentation, and notes.
How do I write a code block in Markdown?: Wrap code in triple backticks (```) on their own lines, optionally adding a language name after the opening fence for syntax highlighting.
Does Markdown work the same everywhere?: Core syntax is consistent, but flavors differ. GitHub Flavored Markdown adds tables, task lists, and strikethrough on top of standard Markdown.