Guide de syntaxe Markdown
Un aide-mémoire clair pour le Markdown du quotidien. Chaque bloc montre la syntaxe et le résultat obtenu.
Qu'est-ce que le Markdown ?
Le Markdown est une façon légère d'ajouter de la mise en forme à du texte brut. Au lieu de boutons et de menus, vous utilisez quelques symboles simples, comme # pour un titre ou * pour l'emphase, qui restent lisibles même en texte brut.
Créé par John Gruber et Aaron Swartz en 2004, il est devenu la norme pour les README, la documentation, les notes, et des sites comme GitHub et Reddit. Comme c'est simplement du texte, votre écriture reste portable et lisible partout.
Ce guide couvre la syntaxe que vous utiliserez le plus souvent. Ouvrez n'importe quel exemple dans Markdown Peek et appuyez sur la barre d'espace pour basculer entre la source et le résultat rendu.
Titres
Commencez une ligne par un à six caractères #. Plus de dièses signifie un titre plus petit, plus profond.
Markdown
# Heading 1 ## Heading 2 ### Heading 3 #### Heading 4
Résultat
Heading 1
Heading 2
Heading 3
Heading 4
Gras, italique et plus
Entourez le texte de symboles pour le mettre en emphase. Combinez-les librement.
Markdown
**Bold text** *Italic text* ***Bold and italic*** ~~Strikethrough~~ `Inline code`
Résultat
Bold text
Italic text
Bold and italic
Strikethrough
Inline code
Listes
Utilisez un tiret, un astérisque ou un plus pour les puces, et des nombres pour les listes numérotées. Indentez pour imbriquer.
Markdown
- First item - Second item - Nested item - Third item 1. Step one 2. Step two
Résultat
- First item
- Second item
- Nested item
- Third item
- Step one
- Step two
Liens
Mettez le texte visible entre crochets et l'adresse entre parenthèses.
Markdown
[Markdown Peek](https://markdownpeek.com) <https://markdownpeek.com>
Images
Une image est un lien précédé d'un point d'exclamation. Le texte entre crochets est le texte alternatif.
Markdown
Résultat
Citations
Commencez une ligne par > pour la citer. Ajoutez un autre > pour imbriquer une citation dans une citation.
Markdown
> A quote worth remembering. > > > And a nested one.
Résultat
A quote worth remembering.
And a nested one.
Code
Entourez le code en ligne de simples apostrophes inversées, et les blocs entiers de triples apostrophes inversées, avec un nom de langage optionnel.
Markdown
Use `backticks` for inline code.
```js
function hi() {
console.log("Hello");
}
```Résultat
Use backticks for inline code.
function hi() {
console.log("Hello");
}Tableaux
Séparez les colonnes par des barres verticales et soulignez la ligne d'en-tête avec des tirets. Les deux-points définissent l'alignement.
Markdown
| Feature | Supported | |---------|:---------:| | Tables | Yes | | Code | Yes |
Résultat
| Feature | Supported |
|---|---|
| Tables | Yes |
| Code | Yes |
Séparateurs horizontaux
Trois tirets, astérisques ou tirets bas ou plus, seuls sur leur ligne, tracent un séparateur.
Markdown
Above the line. --- Below the line.
Résultat
Above the line.
Below the line.
Listes de tâches
Un élément de liste avec [ ] est une tâche ouverte, et [x] une tâche terminée.
Markdown
- [x] Read the guide - [ ] Set as default app
Résultat
- Read the guide
- Set as default app
Échapper des caractères
Placez une barre oblique inverse avant un symbole pour l'afficher tel quel plutôt que comme mise en forme.
Markdown
\*Not italic\* \# Not a heading
Résultat
*Not italic*
# Not a heading
Maths avec LaTeX
Entourez du LaTeX de simples signes dollar pour des maths dans une phrase, ou de doubles signes dollar pour une formule sur sa propre ligne. Markdown Peek affiche les deux, hors ligne.
Markdown
Inline math like $E = mc^2$ works in a sentence. $$ a^2 + b^2 = c^2 $$
Résultat
Inline math like E = mc2 works in a sentence.
a2 + b2 = c2
Diagrammes avec Mermaid
Ouvrez un bloc de code délimité avec mermaid et décrivez un organigramme ou un diagramme de séquence en texte brut. Markdown Peek le dessine pour vous, en mode clair ou sombre.
Markdown
```mermaid flowchart LR A[Write] --> B[Preview] B --> C[Share] ```
Résultat
Lisez le Markdown magnifiquement sur votre Mac
Markdown Peek affiche n'importe quel fichier .md dans un style GitHub épuré, avec Quick Look dans le Finder et l'enregistrement en PDF. Gratuite sur le Mac App Store.
