Le Markdown

Un peu d’histoire#


Le markdown a été créé par John Gruber afin de faciliter l’écriture de texte et d’en améliorer la visibilité. Il s’agit d’un langage de balisage léger permettant à l’utilisateur d’écrire du contenu de manière structurée sans avoir à se concentrer sur le rendu et le style. L’utilisation d’un convertisseur markdown générerera des documents stylisés dans différents formats.

The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. While Markdown’s syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.

~John Gruber

Bien que John Gruber ait défini la syntaxe du markdown de manière générale, il n’existe pas de spécification détaillée de ce langage et donc des ambiguités quant à son implémentation. Par conséquent il existe plusieurs types de markdown, chacun avec ses spécificités.

Le markdown dans Hugo#


Dans le cas de Hugo, le convertisseur markdown utilisé est Goldmark et permet de convertir du markdown en HTML. Il s’appuie sur la spécification CommonMark qui tend à définir de manière précise et sans ambiguité l’implémentation du markdown.

La Syntaxe Markdown#