Guide de formatage

Markdown du nouveau Reddit

Markdown est le format dans lequel le contenu est rédigé sur Reddit. Ceci est le guide du Markdown spécifique à Reddit mis à jour pour le nouveau Reddit et valable depuis le 19 septembre 2018.

À propos de ce document

Le contenu textuel de Reddit (commentaires, auto-publications et autres) est représenté sous la forme d'une variante spécifique à Reddit de Markdown. Ce format a changé dans le nouveau Reddit, tant dans la manière dont il est parsé que dans celle dont il est rendu. Ce guide sur le format Markdown de Reddit explique d'une manière générale comment formater le contenu sur le nouveau Reddit et identifie précisément les domaines dans lesquels le format Markdown du nouveau Reddit diffère de celui de l'ancien.

Ceux qui soumettent exclusivement du contenu via l'éditeur par défaut « Fancy Pants » sur le nouveau Reddit ne sont pas concernés par les détails mentionnés ici. Il n'est pas nécessaire de connaître ces informations pour utiliser Reddit : Fancy Pants est un éditeur de texte enrichi qui fournit toutes les options de formatage courantes, telles que les caractères gras ou italiques, les listes, etc.

Dans ce guide, les exemples sont présentés par paires : ils montrent d'abord comment le Markdown est écrit dans l'éditeur, puis comment il est rendu ou affiché à l'écran. Les remarques importantes relatives au nouveau Reddit qui portent sur les différences entre le Markdown du nouveau Reddit et le Markdown de l'ancien Reddit sont mises en avant dans des paragraphes en italiques marqués par une boule de cristal (🔮) tandis que les astuces sont indiquées par une fleur de lys (⚜).

Référence rapide

Ceci est un condensé de la syntaxe courante de Markdown. Si vous souhaitez en savoir (beaucoup) plus, poursuivez votre lecture.

Écrit	Rendu
_italique_ ou *italique*	italique
__bold__ ou **gras**	gras
___bold-italic___ ou ***gras-italique***	gras-italique
~~barré~~	barré
>!spoilers!<	spoilers
^exposant ou ^(exposant)	exposant
`code`	code

Écrit	Rendu
https://www.reddit.com	https://www.reddit.com
r/annonces	r/annonces
u/reddit	u/reddit

---

Écrit :

[lien](https://redditinc.com)

ou

[lien][1]

[1]: https://redditinc.com`

Rendu :

lien

---

Écrit :

# En-tête 1
## En-tête 2

Rendu :

En-tête 1

En-tête 2

---

Écrit :

- a
- b
  1. c
  2. d

Rendu :

• a
• b
  1. c
  2. d

---

Écrit :

> Lorem blockquote dolor sit amet, consectetur adipiscing elit.
> Sed ullamcorper enim libero, ut luctus lorem ultricies ut.
> Aenean sed nulla a mauris posuere aliquam bibendum id ipsum.
> Fusce non augue mollis, dictum libero sed, blockquote enim.

Rendu :

Lorem blockquote dolor sit amet, consectetur adipiscing elit. Sed ullamcorper enim libero, ut luctus lorem ultricies ut. Aenean sed nulla a mauris posuere aliquam bibendum id ipsum. Fusce non augue mollis, dictum libero sed, blockquote enim.

---

Écrit :

| titre | titre | titre | titre |
|--------|:-------|-------:|:------:|
| texte  | texte  | texte  | texte  |

Rendu :

titre	titre	titre	titre
texte	texte	texte	texte

---

Écrit (notez le retrait) :

    fn main() {
        println!("hey")
    }

Rendu :

fn main() {
    println!("hey")
}

Où utiliser Markdown sur Reddit

Le contenu en Markdown peut être soumis à différents endroits sur Reddit. Markdown est principalement utilisé dans le texte proprement dit des publications (le corps de texte d'une publication) et dans les commentaires.

Lorsque vous soumettez une publication textuelle ou un commentaire dans le nouveau Reddit, vous soumettez par défaut du contenu non Markdown via l'éditeur WYSIWYG « Fancy Pants » (sur ordinateur du moins, la situation peut être différente sur les plateformes mobiles). Si vous cliquez sur « Passer à Markdown » dans l'écran suivant la soumission, vous soumettrez du contenu Markdown. Certains membres peuvent préférer Markdown à Fancy Pants pour bénéficier d'un contrôle plus précis sur leur document, pour accéder à certaines fonctionnalités qui ne sont pas prises en charge par Fancy Pants ou simplement pour une raison de préférence personnelle.

D'autres éléments prennent en charge Markdown :

• Wikis – Certains subreddits possèdent leurs propres wikis et il existe un wiki qui porte sur l'ensemble du site.
  • Par exemple, https://www.reddit.com/r/funny/wiki/index
  • Par exemple, https://www.reddit.com/wiki/faq
• Le texte des soumissions des subreddits (le texte qui s'affiche dans l'ancien Reddit lors de la soumission d'une publication sur un subreddit).
• La « zone de texte » de la colonne de droite du nouveau Reddit.
• Les règles des subreddits : celles-ci s'affichent à plusieurs endroits, principalement dans la colonne de droite, mais aussi sur d'autres pages.
  • Par exemple, https://www.reddit.com/r/funny/about/rules
  • Par exemple, https://www.reddit.com/r/funny/about/sidebar
• Le texte « À propos de » sur le profil de certains membres du nouveau Reddit ; actuellement en version bêta (en tant que fonctionnalité en option).

Il existe des différences majeures en ce qui concerne la prise en charge de ces derniers cas entre l'ancien et le nouveau Reddit, ainsi que l'ancien et le nouveau parseur de Markdown. Pour en savoir plus, voir Différences de prise en charge de contenu entre l'ancien et le nouveau Reddit.

Markdown de Reddit

Paragraphes et sauts de ligne

Sur Reddit, les paragraphes apparaissent sous forme de lignes de texte séparées par des lignes vierges.

Écrit :

Très loin, dans les profondeurs inexplorées de
l'extrémité démodée du bras en spirale occidental
de la Galaxie, se trouve un petit soleil jaune à
peine perceptible.

Tournant dans son orbite à environ quatre-vingt douze
millions de miles, se trouve une petite planète bleue
totalement insignifiante, où des créatures descendues
des grands singes sont tellement primitives qu'elles
pensent toujours que les montres numériques sont une
trouvaille fascinante.

Cette planète a - ou plutôt, avait - un problème :
la majorité de ses habitants étaient malheureux la
plupart du temps. De nombreuses solutions furent
suggérées pour résoudre ce problème, mais elles se
résumaient généralement à des mouvements de petits
papiers verts, ce qui est étrange, car d'une manière
générale, ce n'étaient pas ces petits papiers verts
qui étaient malheureux.

Rendu :

Très loin, dans les profondeurs inexplorées de l'extrémité démodée du bras en spirale occidental de la Galaxie, se trouve un petit soleil jaune à peine perceptible.

Tournant dans son orbite à environ quatre-vingt douze millions de miles, se trouve une petite planète bleue totalement insignifiante, où des créatures descendues des grands singes sont tellement primitives qu'elles pensent toujours que les montres numériques sont une trouvaille fascinante.

Cette planète a - ou plutôt, avait - un problème : la majorité de ses habitants étaient malheureux la plupart du temps. De nombreuses solutions furent suggérées pour résoudre ce problème, mais elles se résumaient généralement à des mouvements de petits papiers verts, ce qui est étrange, car d'une manière générale, ce n'étaient pas ces petits papiers verts qui étaient malheureux.

Veuillez noter que les sauts de ligne ne s'affichent pas, car les lignes adjacentes sont en fait jointes pour créer un seul paragraphe. Il est possible d'ajouter des sauts de ligne explicitement en terminant les lignes par deux espaces ou une barre oblique inversée (\).

Écrit (notez les doubles espaces à la fin de la première ligne) :

L'amour est l'ensemble.  
Nous ne sommes que des parties.

Rendu :

L'amour est l'ensemble.
Nous ne sommes que des parties.

Écrit (notez le positionnement et l'orientation de la barre oblique) :

Au-delà des idées du mal\
et du bien s'étend un champ.\
Je t'y retrouverai.

Rendu :

Au-delà des idées du mal
et du bien s'étend un champ.
Je t'y retrouverai.

🔮 Remarque relative au nouveau Reddit : la création de sauts de ligne avec une barre oblique inversée ne fonctionne que dans le nouveau Reddit. Même si la barre oblique inversée est plus facile à lire et à écrire que les deux espaces, pour assurer la compatibilité avec l'ancien Reddit, utilisez deux espaces pour créer des sauts de ligne.

Les paragraphes sont séparés par un certain nombre de lignes vierges, lesquelles ne sont pas rendues elles-mêmes. Par conséquent, on ne peut pas ajouter un espace arbitraire entre les paragraphes simplement en insérant des lignes vierges.

Écrit :

Ne vous inquiétez pas.\
Pensez à ceux qui ont créé la pensée !



Pourquoi restez-vous en prison\
alors que la porte est grande ouverte ?

Rendu :

Ne vous inquiétez pas.
Pensez à ceux qui ont créé la pensée !

Pourquoi restez-vous en prison
alors que la porte est grande ouverte ?

⚜️ Astuce : pour insérer des lignes vierges, créez un paragraphe ne contenant qu'une espace insécable.

Écrit :

Ne vous inquiétez pas.\
Pensez aux personnes qui qui ont créé la pensée !

 

Pourquoi restez-vous en prison\
alors que la porte est grande ouverte ?

Rendu :

Ne vous inquiétez pas.
Pensez à ceux qui ont créé la pensée !

Pourquoi restez-vous en prison
alors que la porte est grande ouverte ?

Ce   est une sorte d'entité HTML qui permet d'avoir recours à certaines « astuces » dans le format Markdown.

Formatage de base du texte

Le texte en italique se distingue du texte environnant par un astérisque (*) ou un tiret bas (_).

Écrit :

Seules les *erreurs*, et non la _vérité_,
ne supportent pas l'examen.

Rendu :

Seules les erreurs, et non la vérité, ne supportent pas l'examen.

Le texte en gras se distingue du texte environnant par deux astérisques (**) ou deux tirets bas (__).

Écrit :

Seules les **erreurs**, et non __truth___,
ne supportent pas l'examen.

Rendu :

Seules les erreurs, et non la vérité, ne supportent pas l'examen.

Le texte en gras-italique se distingue du texte environnant par trois astérisques (***) ou trois tirets bas (___).

Écrit :

Seules les ***erreurs***, et non ___truth___,
ne supportent pas l'examen.

Rendu :

Seules les erreurs, et non la vérité, ne supportent pas l'examen.

Les exemples précédents portaient sur un seul mot, mais il est aussi possible de mettre en valeur plusieurs mots.

Notez que dans les exemples précédents, les mots mis en évidence étaient entourés d'astérisques ou de tirets bas. On peut aussi mettre en évidence certaines parties de mots, mais uniquement avec des astérisques.

Écrit :

C'est totalement sub*der*ma**togly**phique.

Rendu :

C'est totalement subdermatoglyphique.

Le texte barré se distingue du texte environnant par deux tildes (~~).

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à ~~aimer~~ redditer et à être ~~aimé~~
reddité en retour.

Rendu :

La plus grande chose que vous apprendrez, c'est simplement à aimer redditer et à être aimé reddité en retour.

Les spoilers peuvent être masqués en tant que spoilertext en entourant le texte de >! et !<.

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à >!redditer et à être reddité en retour!<.

Rendu :

La plus grande chose que vous apprendrez, c'est simplement à redditer et à être reddité en retour.

Le texte en exposant se distingue du texte environnant par des parenthèses précédées d'un accent circonflexe (^).

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à redditer ^(et à être reddité en retour).

Rendu :

La plus grande chose que vous apprendrez, c'est simplement à redditer ^{et à être reddité en retour}.

Un seul mot peut aussi être mis en exposant en le précédant d'un simple accent circonflexe.

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à ^redditer et à être ^reddité en retour.

Rendu :

Ce que vous apprendrez, c'est simplement à ^redditer et à être ^reddité en retour.

🔮 Note concernant le nouveau Reddit : Il existe des différences notables dans l'analyse de l'exposant entre l'ancien Reddit et le nouveau Reddit. En particulier, l'ancien Reddit ne parvient pas toujours à analyser la forme entre parenthèses si elle contient des liens (comme ^(a [b](http://exemple.com))). Le nouveau Reddit ne prend pas (encore) en charge les niveaux multiples d'exposant. Et il y a des bugs. Dans les deux cas. Pour une compatibilité maximale entre l'ancien et le nouveau Reddit, utilisez la syntaxe de l'exposant pour un seul mot, sans parenthèse, et mettez chaque mot en exposant, ou séparez les mots avec des entités HTML, soit une « espace insécable » ( ) ou « une espace fine » ( ) (ces dernières permettent des sauts de ligne dans l'exposant).

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à redditer ^et ^à ^être ^reddité ^en ^retour.

Rendu :

La plus grande chose que vous apprendrez, c'est simplement à redditer ^{et à être reddité en retour.}

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à redditer ^et à être reddité en retour.

Rendu :

La plus grande chose que vous apprendrez, c'est simplement à redditer ^{et à être reddité en retour.}

Et si votre exposant contient des liens, appliquez l'exposant au texte des liens également.

Écrit :

La plus grande chose que vous apprendrez, c'est
simplement à redditer ^et
[^à ^être ^reddité](https://www.redditgifts.com)
 ^en ^retour.

Rendu :

Ce que vous apprendrez, c'est simplement à redditer ^{et à être reddité en retour.}

Liens

Les URL commençant par « http:// » ou « https:// » sont automatiquement transformées en hyperliens, de même que les noms de subreddit et les pseudonymes. Ces derniers sont appelés redditlinks et userlinks, respectivement. Collectivement, ils portent le nom autolinks.

Écrit	Rendu
http://www.reddit.com	http://www.reddit.com
https://www.reddit.com	https://www.reddit.com
/r/announcements	/r/announcements
r/annonces	r/annonces
/u/reddit	/u/reddit
u/reddit	u/reddit

⚜️ Astuce : les URL complexes peuvent être parfois parsées de manière inattendue comme des autolinks. Lorsque vous constatez qu'une URL ne fonctionne pas correctement, vous pouvez placer le lien entre crochets (<, >).

Écrit :

<http://example.com/foo/../bar..>

Rendu :

http://example.com/foo/../bar..

Un texte peut être transformé en hyperlien de manière explicite en l'entourant de crochets, suivis d'une URL entre parenthèses. Il est également possible d'attribuer un titre au lien, qui apparaît généralement dans le navigateur lorsque le membre passe le curseur sur le lien.

Le titre doit être entouré de guillemets simples, de guillemets doubles ou de parenthèses.

Écrit	Rendu
[Charlemagne](https://fr.wikipedia.org/wiki/Charlemagne)	Charlemagne
[Zappa](https://fr.wikipedia.org/wiki/Frank_Zappa "Frank Zappa - Wikipedia")	Zappa
[Gandhi](https://fr.wikipedia.org/wiki/Mahatma_Gandhi 'Mahatma Gandhi - Wikipedia')	Gandhi
[Twain](https://fr.wikipedia.org/wiki/Mark_Twain (Mark Twain - Wikipedia))	Twain

🔮 Remarque relative au nouveau Reddit : les titres entre parenthèses ne sont pris en charge que dans le nouveau Reddit. Pour assurer la compatibilité, utilisez des guillemets.

Les liens peuvent aussi être définis comme des références extérieures au paragraphe.

Écrit :

Il en faut [très peu] pour être heureux ;
tout dépend de vous, de votre [façon de penser][wot].

[Très peu] : https://www.reddit.com/r/Meditation/
[wot] : https://www.reddit.com/r/ChangeMyView/

Rendu :

Il en faut très peu pour être heureux ; tout dépend de vous, de votre façon de penser.

Par défaut, le nom de la référence est identique au texte entre crochets, mais la référence peut être nommée explicitement dans une deuxième série de crochets, comme dans [façon de penser][wot]. Comme les liens en ligne, les liens de référence peuvent porter des titres.

⚜️ Astuce : les liens de référence sont particulièrement utiles pour désencombrer les textes qui contiennent beaucoup de liens.

Écrit :

Quelque part dans [la Mancha][lm], dans un lieu dont
j'ai oublié le nom, vivait il n'y a pas si longtemps
un homme, un de ceux qui gardent une [lance] et un
[ancien bouclier][ab] sur une étagère et qui possèdent
une [jument efflanquée][je] et un lévrier de course.

[lm] : https://fr.wikipedia.org/wiki/La_Manche_(province_historique_d%27Espagne)
[lance] : https://fr.wikipedia.org/wiki/Sainte_Lance "Sainte Lance - Wikipedia"
[ab] : https://fr.wikipedia.org/wiki/Bouclier_(arme)
[je] : https://fr.wikipedia.org/wiki/%C3%89pona (Épona - Wikipedia)

Rendu :

Quelque part dans la Mancha, dans un lieu dont j'ai oublié le nom, vivait il n'y a pas si longtemps un homme, un de ceux qui gardent une lance et un ancien bouclier sur une étagère et qui possèdent une jument efflanquée et un lévrier de course.

⚜️ Astuce : notez que les liens ne peuvent contenir des parenthèses que s'ils sont « équilibrés », c'est-à-dire si à chaque « ( » correspond une « ) ». Pour lier une URL à des parenthèses non équilibrées, il faut soit échapper la parenthèse avec une barre oblique inversée (« \ »), soit utiliser la syntaxe de liaison alternative en plaçant l'URL entre crochets (« < » et « > »).

Écrit :

[Parenthèses](https://fr.wikipedia.org/wiki/\()

Rendu :

Parenthèses

Écrit :

[Parenthèses](<https://fr.wikipedia.org/wiki/(>)

Rendu :

Parenthèses

Sur Reddit, les liens doivent généralement inclure le schéma d'URI, par exemple « https:// », donc au lieu de [a](www.exemple.com), ce sera [a](https://www.exemple.com).

L'ensemble complet de préfixes acceptés dans les URL est le suivant : « http:// », « https:// », « ftp:// », « mailto: », « git:// », « steam:// », « irc:// », « news:// », « mumble:// », « ssh:// », « ircs:// », « ts3server:// », « / », « # ».

En-têtes

Il existe six niveaux d'en-têtes de section et ils sont précédés d'un symbole dièse (#).

Écrit :

# Domaine

## Règne

### Embranchement

#### Classe

##### Ordre

###### Famille

Rendu :

Domaine

Règne

Embranchement

Classe

Ordre

Famille

Les en-têtes de niveaux 1 et 2 peuvent aussi être indiqués en soulignant le texte de l'en-tête avec « = » et « - » respectivement.

Écrit :

Domaine
======

Règne
-------

Rendu :

Domaine

Règne

Listes

Les listes peuvent être non ordonnées (à puces) ou ordonnées (numérotées).

Les listes non ordonnées se composent de lignes précédées de « - » ou « * ».

Écrit :

- Agamemnon
- Les Porteurs de libations
- Les Euménides

Rendu :

• Agamemnon
• Les Porteurs de libations
• Les Euménides

Écrit :

* Agamemnon
* Les Porteurs de libations
* Les Euménides

Rendu :

• Agamemnon
• Les Porteurs de libations
• Les Euménides

Les listes ordonnées se composent de lignes numérotées délimitées par « . » ou « ) ».

Écrit :

1. Agamemnon
2. Les Porteurs de libations
3. Les Euménides

Rendu :

1. Agamemnon
2. Les Porteurs de libations
3. Les Euménides

Écrit :

1) Agamemnon
2) Les Porteurs de libations
3) Les Euménides

Rendu :

1. Agamemnon
2. Les Porteurs de libations
3. Les Euménides

🔮 Remarque relative au nouveau Reddit : l'utilisation de « ) » pour définir des listes ordonnées ne fonctionne que dans le nouveau Reddit. Pour assurer la compatibilité avec l'ancien Reddit, utilisez « . ».

Sur Reddit, les listes ordonnées doivent commencer par « 1 ».

En dehors de la numérotation, les listes non ordonnées et ordonnées sont généralement parsées de la même manière. Par conséquent, les exemples restants utiliseront des listes non ordonnées pour plus de simplicité.

Chaque entrée d'une liste est appelée élément de liste. Les éléments peuvent être séparés par n'importe quel espace. L'ajout d'un espace peut rendre des éléments de liste complexes plus lisibles lors de la mise en forme.

Écrit :

- Agamemnon

- Les Porteurs de libations


- Les Euménides

Rendu :

• Agamemnon

• Les Porteurs de libations

• Les Euménides

Les éléments de liste peuvent contenir des sous-listes.

Écrit :

- Homère
  - L'Iliade
  - L'Odyssée
- Eschyle
  - Agamemnon
  - Les Porteurs de libations
  - Les Euménides

Rendu :

• Homère
  • L'Iliade
  • L'Odyssée
• Eschyle
  • Agamemnon
  • Les Porteurs de libations
  • Les Euménides

Notez que les sous-listes de listes non ordonnées doivent être précédées d'au moins deux espaces, tandis que les sous-listes de listes ordonnées doivent être précédées d'au moins trois espaces.

Les listes peuvent contenir des paragraphes, des blocs de citations et d'autres types de contenu.

Écrit :

- Tout d'abord: Lorem ipsum dolor sit amet, consectetur adipiscing
  elit.

  > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
  > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
  > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
  > pretium dui. Nam eget consequat eros, eget commodo urna.

- Mais ensuite : Phasellus vitae libero sit amet orci tempor lacinia
  sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio
  sapien, et condimentum velit convallis et.

  ### Lipsum facts

  |Lorem|Ipsum|Dolor|
  |-----|-----|-----|
  |8    |1    |3    |
  |3    |7    |8    |

  Aenean at dui in sapien sagittis sodales.

Rendu :

• Tout d'abord : Lorem ipsum dolor sit amet, consectetur adipiscing elit.

  Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

• Mais ensuite : Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

  Lipsum facts

  Lorem	Ipsum	Dolor
  8	1	3
  3	7	8

  Aenean at dui in sapien sagittis sodales.

🔮 Remarque relative au nouveau Reddit : dans le format Markdown, le + peut aussi être utilisé pour établir des listes non ordonnées, y compris sur l'ancien Reddit. Pour le moment, le nouveau Reddit n'est pas en mesure de parser ces listes.

Blocs de citations

Les blocs de citations permettent de mettre en évidence des quantités de texte plus importantes, généralement utilisées dans les réponses aux commentaires pour citer les commentaires d'autres utilisateurs. Pour les créer, il suffit de commencer une ligne par un crochet fermant (>).

Écrit :

> Il est si difficile d'oublier la douleur, mais encore plus
difficile de se souvenir de la douceur. Le bonheur ne laisse aucune cicatrice.
Nous apprenons si peu de la paix.

Rendu :

Il est si difficile d'oublier la douleur, mais encore plus difficile de se souvenir de la douceur. Le bonheur ne laisse aucune cicatrice. Nous apprenons si peu de la paix.

Pour les citations simples, il suffit de commencer la première ligne du paragraphe par >, comme ci-dessus, et l'ensemble constituera un bloc de citation.

Pour les blocs de citation plus complexes, commencez chaque ligne par >.

Écrit :

> - Tout d'abord : Lorem ipsum dolor sit amet, consectetur adipiscing
>   elit.
>
> - Mais ensuite: Phasellus vitae libero sit amet orci tempor lacinia
>   sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio
>   sapien, et condimentum velit convallis et.
>
> > Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare
> > enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed
> > rutrum luctus. Nunc massa est, egestas eget massa id, lacinia
> > pretium dui. Nam eget consequat eros, eget commodo urna.
>
> ### Lipsum facts
>
> |Lorem|Ipsum|Dolor|
> |-----|-----|-----|
> |8    |1    |3    |
> |3    |7    |8    |
>
> Aenean at dui in sapien sagittis sodales.

Rendu :

• Tout d'abord : Lorem ipsum dolor sit amet, consectetur adipiscing elit.

• Mais ensuite : Phasellus vitae libero sit amet orci tempor lacinia sed at tellus. Curabitur sit amet nibh elit. Quisque pulvinar odio sapien, et condimentum velit convallis et.

Fusce hendrerit, nunc quis rhoncus tristique, neque augue ornare enim, ut aliquam libero diam et ligula. Aliquam sagittis sem sed rutrum luctus. Nunc massa est, egestas eget massa id, lacinia pretium dui. Nam eget consequat eros, eget commodo urna.

Lipsum facts

Lorem	Ipsum	Dolor
8	1	3
3	7	8

Aenean at dui in sapien sagittis sodales.

Tableaux

Les tableaux se composent d'une ligne d'en-tête et d'un nombre variable de lignes de contenu. Les colonnes sont séparées par des lignes verticales (|) et la ligne d'en-tête est séparée des lignes de contenu par des tirets (-).

Écrit :

| Code | Investissement | Profit |
|--------|------------|--------|
| BTC    | 100 $       | -50 $   |
| ETH    | 1 000 $      | -500 $  |
| DOGE   | 10 000 $    | -5 000 $ |

Rendu :

Code	Investissement	Profit
BTC	100 $	-50 $
ETH	1 000 $	-500 $
DOGE	10 000 $	-5 000 $

Cette deuxième ligne du tableau, qui contient des tirets, est la ligne de marqueur qui détermine l'alignement du texte dans la colonne. Les colonnes de la ligne de marqueur commençant par : sont alignées à gauche ; les colonnes se terminant par : sont alignées à droite ; les colonnes commençant et se terminant par : sont centrées ; les colonnes contenant uniquement des tirets appliquent l'alignement par défaut (à gauche).

Écrit :

| Code | Investissement | Profit |
|:-------|-----------:|:------:|
| BTC    | 100 $       | -50 $   |
| ETH    | 1 000 $      | -500 $  |
| DOGE   | 10 000 $     | -5 000 $ |

Rendu :

Code	Investissement	Profit
BTC	100 $	-50 $
ETH	1 000 $	-500 $
DOGE	10 000 $	-5 000 $

Heureusement, les colonnes n'ont pas à être formatées de façon à s'aligner les unes avec les autres. Elles peuvent être en désordre.

Écrit :

| Code | Investissement | Profit |
|:-|-:|:-:|
| BTC | 100 $ | -50 $ |
| ETH | 1 000 $ | -500 $ |
| DOGE | 10 000 $ | -5 000 $ |

Rendu :

Code	Investissement	Profit
BTC	100 $	-50 $
ETH	1 000 $	-500 $
DOGE	10 000 $	-5 000 $

⚜️ Astuce : les tableaux ne doivent pas obligatoirement contenir une barre verticale en début et en fin de ligne (|), mais le résultat pourrait vous surprendre si le parseur doit deviner si la ligne fait partie d'un tableau ou représente un autre élément. Les lignes verticales au début et à la fin indiquent explicitement que vous créez un tableau.

Blocs de code et code en ligne

Il existe plusieurs moyens de représenter le code dans le format Markdown, mais il est toujours rendu dans une police à un seul espace et exactement tel qu'il est rédigé. Aucun contenu Markdown n'est interprété à l'intérieur d'une zone de code.

Il est possible d'intégrer des extraits de code courts, c'est-à-dire du code en ligne, dans les paragraphes et autres textes. Ils sont délimités par des guillemets obliques (` ).

Écrit :

Nous avions tort : `goto`\
n'est pas considéré comme nocif ;\
`goto` souhaite aider.

Rendu :

Nous avions tort : goto
n'est pas considéré comme nocif ;
goto souhaite aider.

Les blocs de code, plus longs, peuvent être représentés de différentes manières. La première consiste à mettre en retrait l'ensemble des quatre espaces du bloc de code.

Écrit :

    hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
    hashOut.length = SSL_SHA1_DIGEST_LEN;
    if ((err = SSLFreeBuffer(&hashCtx)) != 0)
        goto fail;
    if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
        goto fail;
    if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
    if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
        goto fail;

Rendu :

hashOut.data = hashes + SSL_MD5_DIGEST_LEN;
hashOut.length = SSL_SHA1_DIGEST_LEN;
if ((err = SSLFreeBuffer(&hashCtx)) != 0)
    goto fail;
if ((err = ReadyHash(&SSLHashSHA1, &hashCtx)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &clientRandom)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &serverRandom)) != 0)
    goto fail;
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
    goto fail;
    goto fail;
if ((err = SSLHashSHA1.final(&hashCtx, &hashOut)) != 0)
    goto fail;

🔮 Remarque relative au nouveau Reddit : les blocs de code en retrait sont la seule forme de blocs de code qui fonctionne sur l'ancien Reddit. Utilisez-les pour assurer la compatibilité.

La saisie de quatre espaces avant chaque ligne d'un bloc de code est une opération fastidieuse et sujette aux erreurs. Le moyen le plus simple consiste à encadrer l'ensemble du bloc de code de délimiteurs de code. Un délimiteur de code est une ligne commençant par trois guillemets obliques (`) ou plus ou par trois tildes (~) ou plus.

Écrit :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Rendu :

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

Écrit :

~~~
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
~~~

Rendu :

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;

Les délimiteurs ouvrant et fermant doivent correspondre, aussi bien en termes de caractère utilisé que de nombre.

⚜️ Astuce : lorsque le code en ligne lui-même contient un guillemet oblique ou qu'un bloc de code délimité contient un délimiteur de code, les guillemets obliques et les délimiteurs intérieurs peuvent provoquer une fermeture anticipée de la zone de code. Dans ces cas, les délimiteurs peuvent être ajustés pour s'adapter au code. Le reste de cette section traite des cas particuliers.

Prenons l'exemple suivant.

Écrit :

```

Ce code n'a pas fonctionné comme prévu :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mais il a fait de son mieux.

```

Rendu :

Ce code n'a pas fonctionné comme prévu :

if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0) goto fail; goto fail;

Mais il a fait de son mieux.

Il s'agit d'un délimiteur de code à l'intérieur d'un délimiteur de code (c'est-à-dire un bloc de code Markdown contenant un exemple Markdown) et il n'est pas rendu comme souhaité : le code placé à l'intérieur du délimiteur de code n'est pas rendu comme du code du tout. Le code apparaît plutôt comme un texte classique entouré de deux blocs de code.

Ce problème est facile à résoudre, car la syntaxe du délimiteur de code possède deux délimiteurs différents, (`) et (~), et permet aux blocs de code d'être entourés de plus de trois délimiteurs. Il suffit d'ajouter des guillemets obliques dans le délimiteur de code extérieur ou d'utiliser l'autre délimiteur.

Écrit :

````

Ce code n'a pas fonctionné comme prévu :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mais il a fait de son mieux.

````

Rendu :

Ce code n'a pas fonctionné comme prévu :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mais il a fait de son mieux.

Écrit :

~~~

Ce code n'a pas fonctionné comme prévu :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mais il a fait de son mieux.

~~~

Rendu :

Ce code n'a pas fonctionné comme prévu :

```
if ((err = SSLHashSHA1.update(&hashCtx, &signedParams)) != 0)
        goto fail;
        goto fail;
```

Mais il a fait de son mieux.

Il existe une astuce similaire pour le code en ligne : le code en ligne peut être entouré de n'importe quel nombre de guillemets obliques, et les guillemets ouvrant et fermant doivent correspondre. Par conséquent, s'il faut placer un seul guillemet oblique à l'intérieur d'un code en ligne, il suffit d'entourer le code de deux guillemets, par exemple ``ce signe - ` - est un guillemet oblique``.

Naturellement, il existe une autre situation compliquée ici : et si votre code en ligne lui-même doit commencer ou se terminer par un guillemet oblique ? Par exemple, lorsque vous souhaitez illustrer la manière d'écrire le code en ligne Markdown dans le code en ligne. Il ne suffit pas de placer deux guillemets obliques pour ouvrir le code en ligne et un seul guillemet oblique pour commencer le code en ligne, car cela ressemble à un code en ligne délimité par trois guillemets obliques : ```exemple de code en ligne```. Si vous écriviez simplement cela, vous perdriez les guillemets obliques intérieurs :

Écrit	Rendu
```exemple de code en ligne```	exemple de code en ligne

Markdown offre une « échappatoire » pour ces situations : tout espace entourant le code en ligne est supprimé, ce qui permet d'écrire les délimiteurs de code en ligne, un espace, puis le guillemet oblique du texte :

Écrit	Rendu
`` `exemple de code en ligne` ``	`exemple de code en ligne`

Cette situation se produit le plus souvent pour les personnes qui doivent écrire du contenu portant sur Markdown en utilisant le format Markdown (comme moi). Avec un peu de chance, vous ne la rencontrerez jamais.

Enfin, que faire si vous voulez placer des espaces de début ou de fin dans votre code en ligne ? Eh bien, c'est assez compliqué. Si vous vous trouvez dans cette situation, vous serez suffisamment astucieux pour trouver une solution.

Ruptures thématiques

La rupture thématique, alias la « règle horizontale », est simplement une ligne horizontale tracée en travers de la page. Elle peut servir à créer une séparation visuelle dans le contenu. Une rupture thématique est écrite comme une ligne contenant trois astérisques (*), tirets (-) ou tirets bas (_), voire plus.

Écrit :

Voici une anecdote nostalgique au sujet de papi.---

Voici une photo d'un âne assoupi.

Rendu :

Voici une anecdote nostalgique au sujet de papi.

---

Voici une photo d'un âne assoupi.

Écrit :

Voici un perroquet festif authentique.

***

Voici la tromperie, la déchéance et — finalement — la mort.

Rendu :

Voici un perroquet festif authentique.

---

Voici la tromperie, la déchéance et — finalement — la mort.

Écrit :

Voici une porte de grange rouillée.

___

Café noir.

Rendu :

Voici une porte de grange rouillée.

---

Café noir.

Autres trucs et astuces

Échappement de la syntaxe de Markdown

L'échappement est un moyen d'indiquer au parseur qu'il ne doit pas interpréter les caractères spéciaux comme du Markdown en les précédant d'une barre oblique inversée (\).

On constate parfois que le parseur a interprété le texte de manière inattendue. Cela peut se produire, par exemple, si au milieu d'un paragraphe, un trait d'union commence une nouvelle ligne.

Écrit :

J'ai senti mes poumons se gonfler face à la beauté du
 paysage - l'air, les montagnes, les arbres, les gens.
 J'ai pensé, « Voilà ce que c'est qu'être heureux ».

Rendu :

J'ai senti mes poumons se gonfler face à la beauté du paysage

• l'air, les montagnes, les arbres, les gens. J'ai pensé, « Voilà ce que c'est qu'être heureux ».

Dans ce cas, le trait d'union est censé faire partie du texte et non commencer une liste. Il suffit d'échapper le trait d'union par une barre oblique inversée pour résoudre le problème.

Écrit :

J'ai senti mes poumons se gonfler face à la beauté du
 paysage \- l'air, les montagnes, les arbres, les gens.
 J'ai pensé, « Voilà ce que c'est qu'être heureux ».

Rendu :

J'ai senti mes poumons se gonfler face à la beauté du paysage - l'air, les montagnes, les arbres, les gens. J'ai pensé, « Voilà ce que c'est qu'être heureux ».

Un autre cas courant où un échappement est nécessaire est celui des parenthèses situées dans les liens.

Écrit :

[Parenthèse](https://fr.wikipedia.org/wiki/))

Rendu :

Parenthèse)

Cet exemple est censé être un lien vers l'article Wikipédia au sujet des parenthèses (« https://fr.wikipedia.org/wiki/) »), mais il s'agit en fait d'un lien vers « https://fr.wikipedia.org/wiki/ ». Si vous échappez la parenthèse dans l'URL, le parseur ne la traitera pas comme la parenthèse fermante de la syntaxe du lien.

[Parenthèse](https://fr.wikipedia.org/wiki/\))

Rendu :

Parenthèse

Entités HTML

Markdown prend en charge les entités HTML telles que  , une entité relativement courante qui désigne une espace insécable. Elles peuvent servir « d'échappatoire » pour écrire un contenu difficile à représenter. Par exemple,   est souvent utilisé pour insérer des paragraphes « vides » et fournir un espace vierge vertical là où Markdown ne le permet pas.

Dans les autres cas, on utilise des entités HTML pour entrer les caractères difficiles à saisir, comme ceux qui sont en dehors de la plage ASCII en Unicode ou les caractères qui n'ont pas de représentation visuelle.

Quelques exemples utiles :

• On insère un tiret avec —. Il s'agit d'un tiret plus long que le trait d'union classique et du caractère approprié pour séparer des éléments dans les phrases.
• On peut utiliser différents caractères d'espace vide non ASCII pour insérer des espaces là où Markdown ne le permet pas. Si vous souhaitez simplement saisir un espace d'une taille arbitraire entre deux mots, vous pouvez le faire, par exemple, en insérant plusieurs cadratins ( ).

Conseils relatifs aux robots

Au cours de la transition, nous avons constaté certaines incompatibilités dans la syntaxe utilisée par les bots. Voici quelques remarques résultant de ces expériences, ainsi que des informations d'ordre général au sujet de la publication automatique de Markdown.

Remarque rapide : l'aide d'auteurs de bots serait utile pour cette section !

• Dans les liens, n'insérez pas d'espaces entre le texte ([...]) et l'URL ((http://exemple.com)). Cela fonctionnait sur l'ancien Reddit, mais pas sur le nouveau.

• Insérez un échappement sous forme de barre oblique inversée pour toutes les parenthèses dans les URL (pas les autolinks), comme [texte](http://exemple.com/foo\(bar). Les parenthèses doivent être équilibrées, sinon elles ne seront pas parsées comme des liens. Par conséquent, il faut échapper toutes les parenthèses pour que tous les liens contenant des parenthèses soient correctement parsés.

• Vous pouvez aussi utiliser la syntaxe à crochets pour les URL ([texte](<http://exemple.com>), qui accepte les parenthèses non équilibrées. Dans ce cas cependant, vous devez utiliser les crochets d'échappement aux URL, comme %3C and %3E.

• Si vous publiez des autolinks (URL brutes sans la syntaxe des crochets), pensez à les entourer de crochets (< >) et à utiliser des échappements d'URL pour tous les crochets internes aux URL, comme %3C and %3E. Cela évitera toute ambigüité dans le parsage, en particulier à la fin des autolinks. Notez que même à l'intérieur des crochets, les autolinks ne doivent pas contenir d'espaces : utilisez donc l'échappement d'URL pour ceux-ci comme %20.

• Il n'existe aucun moyen d'échapper quelque chose tout en publiant des liens arbitraires en tant que bot si vous souhaitez que toutes les URL soient parsées comme prévu. Les détails du parsage des liens figurent dans les spécifications.

• Le nouveau parseur et l'ancien traitent les échappements HTML (comme  ) de manière différente : l'ancien les préserve à la fois dans le texte et dans les liens, tandis que le nouveau les enlève pendant le parsage afin que les clients (dont bon nombre ne sont pas des navigateurs Web) n'y soient pas exposés. Ceci est vrai à la fois pour le texte et pour les liens, et est spécifié comme tel par CommonMark. Nous ne savons pas dans quelle mesure les bots seront impactés et n'avons pas de recommandation à proposer pour le moment.

• S'il existe une possibilité que votre contenu en exposant contienne des liens, écrivez-les en mettant chaque mot en exposant ou en séparant les mots en exposant par un espace quart de cadratin. La syntaxe ^(...), plus agréable, n'est pas fiable sur l'ancien Reddit lorsqu'elle est associée à des liens.

Recommandations de compatibilité pour le Markdown de Reddit

Voici quelques recommandations pour écrire du Markdown qui soit compatible avec le parsage de l'ancien Reddit (sous réserve que l'ancien parseur soit toujours utilisé).

Certaines des recommandations sont « faciles », car elles ont des équivalents aussi efficaces dans l'ancien Reddit ; d'autres sont plus « maladroites », car elles favorisent une syntaxe moins agréable.

Il est probable que l'ancien parseur sera entièrement éliminé à un moment donné (il n'est plus utilisé aujourd'hui que sur l'ancien client Web ; les clients mobiles utilisent le nouveau), auquel cas ces recommandations pourraient changer.

D'un autre côté, si vous n'aimez pas le formatage sur l'ancien Reddit, n'hésitez pas à aller à l'opposé de toutes ces suggestions !

Recommandations de compatibilité faciles

• Utilisez des guillemets pour les titres des liens, comme [texte](http://exemple.com "titre") (par opposition aux parenthèses). L'ancien Reddit ne prend pas en charge les parenthèses dans ce cas.

• Commencez et terminez les colonnes de tableaux par des barres verticales (|). C'est techniquement facultatif, mais certains résultats peuvent surprendre lorsqu'on ne les utilise pas. L'ancien et le nouveau Reddit présentent des particularités différentes.

• Délimitez les listes ordonnées par des points au lieu de parenthèses, par exemple (1. Premier). L'ancien Reddit ne prend pas en charge ces dernières.

• Délimitez les listes non ordonnées par des - ou *, pas par des +. Le nouveau Reddit ne prend pas en charge ces derniers éléments pour le moment.

Recommandations de compatibilité maladroites

• Utilisez des doubles espaces à la place des barres obliques inversées pour indiquer les sauts de ligne. L'ancien Reddit ne prend en charge que les doubles espaces.

• Utilisez des blocs de code en retrait au lieu de délimiteurs de code. L'ancien Reddit ne prend en charge que les blocs de code en retrait.

• N'utilisez pas des mises en évidences imbriquées telles que _ceci est __vraiment__ important_. Oui, vous avez deviné : ça ne marche pas dans l'ancien Reddit.

• N'utilisez pas plusieurs niveaux de texte en exposant (c'est-à-dire des « tours »). Cela ne fonctionne pas dans le nouveau Reddit (du moins, pas encore).

• Continuez à utiliser les astuces courantes pour que les exposants prennent en charge les espaces, par exemple en mettant en exposant chaque mot ou en joignant les mots par des caractères d'espacement Unicode exotiques (  ou ​). Évitez la syntaxe d'exposant entre parenthèses, ^(...), car elle est souvent mal parsée dans l'ancien Reddit.

Plus d'informations sur Markdown dans Reddit

Le nouveau parseur Markdown de Reddit, Snoomark, est une variante du langage GitHub-flavored Markdown (GFM) basée sur CommonMark et dotée d'extensions pour tableau et autolink GFM, ainsi que d'une extension modifiée pour les caractères barrés. Cela inclut aussi des extensions spécifiques à Reddit et des particularités de compatibilité spécifiques à Reddit qui s'écartent de CommonMark.

Snoomark est un projet inspiré de comrak, qui est une réimplémentation de cmark-gfm, l'implémentation de CommonMark par GitHub avec des extensions GitHub (GFM), qui est elle-même inspirée de cmark, l'implémentation de référence de CommonMark. Snoomark n'est pas (encore) open source, mais les modifications apportées à comrak sont régulièrement fusionnées dans Snoomark.

À mesure que les membres de Reddit ont commencé à utiliser les outils de création de publications et de formatage du nouveau Reddit, la philosophie autour de la prise en charge de Markdown a progressivement changé. Initialement, le plan était de passer à un dispositif approchant de CommonMark et d'abandonner toute compatibilité avec les « particularités » de l'ancien Reddit. Cependant, au fur et à mesure du déploiement, cette position s'est assouplie et un certain nombre de particularités de compatibilité ont été ajoutées au nouveau parseur.

Il n'est pas actuellement prévu d'ajouter d'autres particularités de compatibilité au nouveau Reddit. Il est plus probable que l'ancien Reddit sera mis à niveau vers le nouveau parseur. Dans ce cas de figure, une certaine quantité (espérons-le, limitée) de l'ancien contenu ne sera plus rendue correctement en raison des différences de parsage.

Cela dit, les orientations futures continueront à être évaluées à mesure que le déploiement se poursuivra et que des bugs seront signalés.

Le rendu de Markdown dans le nouveau Reddit est nettement différent de celui de l'ancien Reddit, et de celui de la plupart des sites Web qui utilisent Markdown, car il n'apparaît pas directement en HTML à partir de Markdown, mais passe par un format de document intermédiaire exclusif à Reddit, appelé RTJSON (« Rich Text JSON »). Ce format est conçu pour être consommé et rendu facilement par tous les clients Reddit, Web et mobiles, alors que dans l'ancien Reddit, les clients mobiles avaient quelques difficultés à rendre le contenu Markdown de manière cohérente. Les détails du format RTJSON n'ont pas encore été publiés.

Motivation pour effectuer la transition vers CommonMark

Le nouveau parseur a été créé parce que l'ancien était difficile à gérer, rédigé en code C critique pour la sécurité et que l'ajout de nouvelles fonctionnalités était extrêmement difficile. Le nouveau parseur n'est pas écrit en code C et est donc plus gérable. En outre, cette refonte a permis d'envisager de nouvelles fonctionnalités et la possibilité d'ajouter d'autres fonctions à l'avenir.

La vitesse de développement de l'ancien parseur était de 0, tandis que le nouveau reçoit les modifications au besoin, et la plupart des changements ne requièrent pas de vérification de sécurité.

Cette refonte a également été l'occasion de mettre à niveau l'ancien dialecte Markdown de Reddit vers un dialecte CommonMark moderne basé sur des normes, afin de bénéficier des avantages du développement continu en amont et du travail sur les normes, et de rattraper environ 6 ans d'évolution de Markdown (alors que le parseur de l'ancien Reddit stagnait). Cette décision a naturellement donné lieu à de nombreuses plaintes, car certaines syntaxes de l'ancien Reddit ne fonctionnent pas dans le nouveau Reddit. Cependant, nous avons progressivement rendu les particularités les plus courantes rétrocompatibles.

Le Markdown du nouveau Reddit bénéficie en outre de plusieurs fonctionnalités intéressantes héritées de CommonMark, notamment les sauts de ligne avec une barre oblique inversée de fin et les blocs de code démarqués par des délimiteurs au lieu de retraits. Pendant la période de transition, ces fonctions ne sont naturellement pas compatibles avec l'ancien Reddit, mais à terme, elles devraient pouvoir être utilisées en toute sécurité, sans avoir à se soucier de la compatibilité. Les clients mobiles comprennent déjà le contenu analysé par le nouveau parseur ; seul l'ancien client Web n'y parvient pas encore.

La seule alternative sérieuse à la mise à niveau vers CommonMark aurait probablement été la réécriture complète de l'ancien parseur dans un langage sûr, en conservant toutes les particularités spécifiques à Reddit. Cela n'a probablement pas été considéré comme souhaitable, à la fois en raison des efforts considérables que cela aurait nécessités, et parce que cela n'aurait été adapté qu'à Reddit. Le nouveau parseur, en revanche, est basé sur un parseur CommonMark régulièrement tenu à jour, ce qui est utile pour tous ceux qui souhaitent parser CommonMark. À long terme, une approche similaire à celle de CommonMark offrira une expérience plus fluide à ceux qui utilisent CommonMark ailleurs, principalement ceux qui possèdent les compétences techniques, car la grande majorité des membres du nouveau Reddit utilisent l'éditeur Fancy Pants. Reddit est maintenant en mesure de rejoindre la communauté CommonMark qui travaille en amont (et a déjà affecté des implémentations en amont et la spécification CommonMark). Encore une fois, la combinaison d'un codebase gérable et d'une norme à laquelle se conformer signifie que Reddit peut tenir à jour son parseur au fil de l'évolution des normes.

Différences entre le Markdown de l'ancien Reddit, le Markdown du nouveau Reddit et CommonMark

Le Markdown du nouveau Reddit a hérité des caractéristiques du Markdown de l'ancien Reddit et de CommonMark / GFM, mais il présente aussi des différences. Cette section répertorie les différences connues du Markdown du nouveau Reddit par rapport à celui de l'ancien Reddit et à CommonMark / GFM. Elle n'est pas exhaustive.

Les différences par rapport à l'ancien Reddit sont souvent héritées de CommonMark. Notez que pour ceux qui souhaitent que leur contenu soit rendu avec précision pour les membres de l'ancien Reddit, il est possible de choisir de ne pas utiliser ces fonctionnalités (voir Recommandations de compatibilité pour le Markdown de Reddit). Les différences par rapport à CommonMark sont souvent destinées à prendre en charge les « particularités » du Markdown de l'ancien Reddit. Les différences par rapport à l'un et à l'autre peuvent être considérées ou non comme des bugs, selon la personne qui examine la situation et selon le moment.

Extensions spécifiques à Reddit

• Spoilertext : le spoilertext (>!spoiler!<) est spécifique à Reddit.

• Exposants : il n'y a pas de norme concernant les exposants et Reddit possède sa propre syntaxe, qui est toujours prise en charge (^, ^(...)).

• Caractères barrés : la syntaxe de Reddit est différente de celle de l'extension GFM.

• Redditlinks et userlinks : les noms des subreddits et des membres de Reddit (précédés du préfixe /r/, r/, /u/ et u/) sont automatiquement transformés en liens.

• Médias en texte enrichi : Reddit prend en charge les soumissions contenant des images, des vidéos et des gifs, lesquels sont encodés dans le Markdown avec une syntaxe d'image intégrée personnalisée. Cette fonction n'est prise en charge que par l'éditeur Fancy Pants (la syntaxe serait excessivement difficile à écrire manuellement à l'heure actuelle).

• Les paragraphes contenant seulement un espace sans chasse ou zero-width space (zero-width) sont des paragraphes vides (l'espace est supprimé dans le rendu). Vous pouvez utiliser le mode d'édition simplifié.

Nouvelles fonctionnalités héritées de CommonMark

• Les listes ordonnées peuvent être écrites avec des parenthèses, alors que l'ancien Reddit ne prenait en charge que les listes ordonnées avec des points : (1) par rapport à 1.).

• Les sauts de ligne forcés peuvent être écrits en terminant les lignes par \, alors que l'ancien Reddit ne prenait cela en charge qu'en terminant les lignes par un double espace. Cette syntaxe est plus lisible et moins surprenante que la syntaxe à double espace.

• Les blocs de code peuvent être entourés de délimiteurs au lieu d'être mis en retrait (``` ou ~~~). Cette syntaxe populaire est peut-être plus facile à écrire et à lire que la syntaxe utilisant le retrait.

Différences par rapport au Markdown de l'ancien Reddit

• La syntaxe des exposants utilisant des parenthèses (^(super duper)) est parsée de manière plus fiable (les exposants contenant des liens fonctionnent correctement) et une fois que l'ancien parseur aura disparu, cette syntaxe devrait généralement être préférée à la syntaxe sans parenthèses (^super).

• Les exposants sont parsés légèrement différemment dans les cas particuliers, comme ^(^b).

• Plusieurs niveaux d'exposants imbriqués sont rendus comme un niveau unique d'exposant. Cela peut être corrigé à l'avenir.

  • Ticket : CREATE-1599

• Le nouveau Reddit ne parse pas correctement les exposants sans parenthèses lorsqu'ils précèdent un mot qui est suivi par un crochet fermant, une parenthèse fermante ou une mise en évidence fermante.

  • Ticket : CREATE-2474

• Les parenthèses sans échappement dans les liens doivent être équilibrées.

  • Discussions précédentes : 1
  • Ticket : CREATE-1662

• Les sous-listes requièrent au moins deux espaces de retrait pour les listes non ordonnées et trois pour les listes ordonnées, alors que l'ancien Reddit nécessitait seulement un espace.

  • Discussions précédentes : 1
  • Ticket : CREATE-1702

• La première cellule d'en-tête d'un tableau ne doit pas être vide si elle n'est pas précédée d'une barre verticale (|). Par exemple, la syntaxe suivante ne fonctionne pas :

  (cette ligne est une astuce pour ouvrir un bloc de code dans l'ancien Reddit et ne fait pas partie de l'exemple)
  
   |B|C
  -|-|-
  d|e|f
  

  • Discussions précédentes : 1
  • Ticket : CREATE-1701

• La première cellule « marqueur » du tableau ne doit pas être un tiret suivi d'un espace si elle n'est pas précédée d'une barre verticale (|), car elle sera alors interprétée comme le début d'une liste. Par exemple, la syntaxe suivante ne fonctionne pas :

  (cette ligne est une astuce pour ouvrir un bloc de code dans l'ancien Reddit et ne fait pas partie de l'exemple)
  
  A | B
  - | -
  c | d
  

  • Discussions précédentes : 1
  • Ticket : CREATE-1708

• Le spoilertext n'a bas besoin d'un « encadrement », car les délimiteurs du spoilertext (>! et !<) seront parsés comme tels, indépendamment de leur proximité avec un espace vide ou un signe de ponctuation.

  • Discussions précédentes : 1
  • Ticket : CREATE-1534

• Le spoilertext des blocs de citations n'est pas pris en charge, autrement dit, les codes de blocs écrits avec >!au lieu de >.

  • Ticket : CREATE-1723

• La syntaxe des liens ne permet pas d'espace entre les crochets ([]) et les parenthèses (()).

  • Discussions précédentes : 1 2
  • Ticket : CREATE-1438

• Plus de deux tildes (~) dans la syntaxe des caractères barrés (par exemple, a ~~~b~~~ c) sont traités différemment : dans l'ancien Reddit, les tildes supplémentaires ne sont pas utilisés, alors que dans le nouveau Reddit, ils sont pris en compte. En outre, dans le nouveau Reddit, plus de deux tildes au début d'une ligne peuvent être interprétés comme des délimiteurs de code.

• Les lignes contenant seulement des dièses (#) sont gérées différemment : dans l'ancien Reddit, ces lignes étaient entièrement utilisées et n'apparaissaient pas ; dans le nouveau Reddit, 6 dièses ou moins sont rendus comme un en-tête vide, tandis que plus de 6 dièses sont rendus comme un paragraphe contenant des dièses.

• Certains cas particuliers concernant le parsage de liens contenant des espaces, en particulier en ce qui concerne leur interaction avec les titres de liens, sont différents.

• Il existe d'autres cas de différence de parsage des liens : certains sont considérés comme des bugs et d'autres restent indéterminés.

  • Discussions précédentes : 1
  • Ticket : CREATE-2206

• Certains cas de parsage « d'intérieur de mot » en gras+italique (alias strong+emph) sont différents. Par exemple, l'ancien Reddit parse a**_b_**c comme gras + italique, alors que ce n'est pas le cas de CommonMark.

  • Discussions précédentes : 1

• Les listes ordonnées doivent commencer par « 1 ». Les autres chiffres initiaux ne sont pas pris en charge. L'ancien Reddit était en mesure de les parser, même s'il rendait toujours les listes comme commençant par 1.

• Le nouveau Reddit autorise régulièrement les mises en évidence imbriquées, comme _a__b c b__d_, alors que l'ancien Reddit produit souvent des erreurs de parsage dans ces cas.

• Les liens imbriqués dans des liens sont parsés différemment, comme [[a](http://exemple.com)](http://exemple.com).

• Le nouveau Reddit n'autorise pas de spoilertext dans le texte des liens.

  • Ticket : CREATE-2623

• Les listes non ordonnées démarquées par des + ne fonctionnent pas dans le nouveau Reddit. Il s'agit d'une violation de la spécification de CommonMark.

  • Ticket : CREATE-2403

• Les en-têtes ne doivent pas contenir d'intégrations arbitraires comme les italiques dans le nouveau Reddit. Il s'agit d'une violation de la spécification de CommonMark.

  • Ticket : CREATE-2668

• De même, le nouveau Reddit accepte qu'un préfixe d'URL seul soit une URL valide, alors que l'ancien Reddit requiert que le préfixe soit suivi d'autres caractères.

• Le contenu d'un paragraphe suivi d'une ligne qui ressemble à une liste non ordonnée est interprété comme la fermeture du paragraphe et l'ouverture de la liste non ordonnée, alors que l'ancien Reddit continuait le paragraphe.

• Les définitions de liens de référence peuvent apparaître à l'intérieur des blocs de citations.

• Les zones de code en ligne contenant des guillemets obliques peuvent contenir n'importe quel nombre de guillemets obliques, alors que dans l'ancien Reddit, les guillemets obliques externes doivent être la chaîne de guillemets la plus longue dans la zone de code.`` `code` `` fonctionne dans les deux, ` ``code`` ` fonctionne seulement dans le nouveau Reddit.

• Les éléments de bloc imbriqués (comme les listes, les blocs de citation et les tableaux) peuvent être ouverts sur la même liste que les éléments de liste.

Différences par rapport à CommonMark / GFM

• Les images imbriquées ne sont pas prises en charge en mode Markdown, seulement en mode Fancy Pants.

• La syntaxe des exposants est similaire à celle de l'ancien Reddit, mais pas à celle de comrak.

• Les listes ordonnées doivent commencer par « 1 ». Les autres chiffres initiaux ne sont pas pris en charge.

• Les liens peuvent contenir des espaces.

• Les lignes contenant uniquement des dièses (#) sont traitées différemment.

• Les en-têtes ne requièrent pas d'espaces après les croisillons.

• Les en-têtes contenant plus de 6 dièses sont parsés différemment, c'est-à-dire comme des en-têtes de niveau 6 avec des dièses dans le texte de l'en-tête (par exemple #######valhallaforolaf). Dans CommonMark, ces constructions ne sont pas parsées comme des en-têtes.

• Une ligne de cellules d'un tableau peut commencer par un tiret suivi d'un espace, alors que dans CommonMark, cela ouvrirait une nouvelle liste non ordonnée.

  (cette ligne est une astuce pour ouvrir un bloc de code dans l'ancien Reddit et ne fait pas partie de l'exemple)
  
  A | B | C
  --|---|--
  - | e | f
  

  Notez cependant que cela ne s'applique pas actuellement à la ligne de marqueur qui suit la ligne d'en-tête. Par conséquent, ce qui suit n'est pas parsé comme un tableau :

  (cette ligne est une astuce pour ouvrir un bloc de code dans l'ancien Reddit et ne fait pas partie de l'exemple)
  
  
  A | B | C
  - | - | -
  - | e | f
  

  alors que c'est le cas dans l'ancien Reddit.

• Les caractères barrés requièrent deux tildes (~~) dans l'ancien Reddit, et non un seul, comme dans CommonMark.

• Les liens relatifs ne sont pas pris en charge.

• Le HTML en ligne n'est pas pris en charge.

• Les listes non ordonnées démarquées par des + ne fonctionnent pas dans le nouveau Reddit.

• Les en-têtes ne doivent pas contenir d'intégrations arbitraires comme les italiques dans le nouveau Reddit.

Différences de prise en charge de contenu entre l'ancien et le nouveau Reddit

La section Où utiliser Markdown sur Reddit décrivait les fonctionnalités spécifiques de Reddit qui acceptent Markdown en entrée. À ce jour, il existe des différences importantes en ce qui concerne la prise en charge de ces différents cas entre l'ancien et le nouveau Reddit, ainsi que l'ancien et le nouveau parseur de Markdown.

Voici les détails précis.

• Auto-texte : bien que le nouveau Reddit utilise le nouveau parseur/outil de rendu de Markdown pour rendre l'auto-texte dans la plupart des emplacements, y compris dans la propre page de cette publication et dans « l'aperçu » (la fenêtre contextuelle qui s'affiche lorsque l'on clique sur une publication dans la page de liste), il utilise l'ancien parseur de Markdown dans les aperçus de la liste, à la fois dans la vue par défaut et dans « l'expando », (c'est-à-dire, les détails qui apparaissent lorsqu'on clique sur l'icône représentant deux flèches opposées) dans la vue classique.

• Wikis : actuellement rendus uniquement via l'ancien Reddit.

• Description de subreddit : non interprétée comme du Markdown dans le nouveau Reddit. En outre, l'ancien contenu multi-lignes est limité à une seule ligne.

• Texte de soumission de subreddit : non rendu du tout dans le nouveau Reddit.

• Colonne de droite de « zone de texte » du nouveau Reddit : utilise l'outil de rendu de l'ancien Reddit.

• Règles de subreddit : toujours rendues avec l'outil de rendu de l'ancien Reddit.

• Texte « À propos de » sur le profil des membres dans le nouveau style : toujours rendu avec l'outil de rendu de l'ancien Reddit.

Différences entre le mode d'édition simplifié et le mode Markdown

L'éditeur WYSIWYG Fancy Pants prend généralement en charge la plupart des fonctionnalités Markdown de Reddit, mais présente certaines limites. Sous son capot, Fancy Pants stocke ses documents comme du Markdown, mais son interface ne prend pas en charge toutes les fonctionnalités Markdown de Reddit.

• Le mode simplifié ne prend pas en charge la saisie d'entités de caractère HTML

• Le mode simplifié a des « limites d'imbrication » beaucoup plus réduites que le Markdown brut.Les limites d'imbrication affectent la profondeur à laquelle les listes imbriquées et les blocs de citations peuvent être créés dans le document.

• Les images et vidéos peuvent être imbriquées dans le contenu via l'éditeur Fancy Pants, mais pas dans le Markdown brut.

• Le mode simplifié ne prend en charge qu'un seul niveau d'en-tête.

• Fancy Pants ne prend pas en charge l'insertion d'éléments de bloc arbitraires comme les listes, les blocs de citations et les tableaux à l'intérieur de listes ou de blocs de citations.

• Fancy Pants ne prend pas en charge les définitions des références de lien (les liens répétés doivent être insérés à plusieurs reprises).

• Le mode simplifié ne prend pas en charge les sauts de ligne forcés.

• Le mode simplifié peut créer des lignes vierges, alors que Markdown ne permet pas de le faire. Il utilise pour ce faire une astuce rétrocompatible en insérant des paragraphes contenant une seule espace sans chasse (zero-width), que le parseur de Markdown convertit ensuite en paragraphe vide. Techniquement, les auteurs qui utilisent Markdown peuvent en faire de même.

Même si la page de soumission peut basculer entre les modes Fancy Pants et Markdown, méfiez-vous du basculement de Markdown à Fancy Pants. Si le passage de Fancy Pants à Markdown est censé s'effectuer sans perte, l'inverse n'est pas vrai. Par exemple, si votre Markdown contient des entités HTML, elles seront converties en Unicode ordinaire pendant la conversion, les listes profondément imbriquées seront perdues, etc. En outre, lors du retour  au mode Markdown depuis le mode simplifié, le Markdown exact que vous avez saisi sera perdu et remplacé par le Markdown généré par le mode simplifié.

Remerciements et lectures recommandées

Un grand merci à /u/brson pour avoir créé ce document et travaillé si dur pour améliorer notre parseur. L'organisation de base de cette page et de son contenu ont été influencés par la page Reddit Markdown Primer de /u/AnteChrono, la page Reddit Comment Formatting de /u/Raerth, la page Wiki existante sur les commentaires et la page d'aide de CommonMark.

Citations et références utilisées comme exemples :

• « Tout là-bas, au fin fond des tréfonds inexplorés... » — Douglas Adams
• « Au-delà du mal... , » L'amour est l'ensemble... «, « Ne vous inquiétez pas... » — Rumi
• « Il en faut très peu pour être heureux... » — Marc Aurèle
• « Quelque part dans la Mancha... » — Miguel de Cervantes
• « Seules les erreurs... » — Thomas Paine
• « La plus grande chose que vous apprendrez... » — Eden Ahbez
• « Agamemnon, ... » — Eschyle
• « Il est si difficile d'oublier la douleur,... » — Chuck Palahniuk
• « J'ai senti mes poumons se gonfler... » — Sylvia Plath