Les notations Markdown

Règles FR

Définition

Markdown est une notation légère. Ses signes typographiques ont une valeur syntaxique : ils ne suivent pas toujours les règles du texte imprimé.

Core
1

Emphase et signes répétés

Les astérisques et underscores doivent rester collés au texte qu’ils balisent. Ajouter des espaces casse souvent la syntaxe.

À éviter

* important *

Correct

*important*

Les astérisques collés au texte balisé ; avec des espaces, la syntaxe casse.

Core
2

Code en ligne

Les backticks encadrent le code en ligne. Leur espacement dépend de la syntaxe Markdown, pas de la ponctuation française.

À éviter

` npm install `

Correct

`npm install`

Les backticks encadrent le code sans espaces intérieurs.

Context
3

Liens et ponctuation

La ponctuation qui appartient à la phrase reste en dehors du lien si elle ne fait pas partie de l’URL ou du libellé.

À éviter

[Voir la documentation.](/docs)

Correct

[Voir la documentation](/docs).

Le point appartient à la phrase : il sort du lien.

Copié dans le presse-papier