# À propos de la syntaxe Markdown
C’est en 2004 que John Gruber et Aaron Schwartz ont proposé le *Markdown* à la communauté informatique . Ils n’avaient ni la prétention ni le pouvoir de créer un « standard » canonique et immuable. Mais l’idée était tellement bonne qu’elle a été adoptée et développée dans différentes directions. Si bien qu’aujourd’hui, on peut dire du *Markdown* qu’il est un « quasi standard ». La définition originelle existe toujours et l’on peut s’y reporter ⭢ [Daring Fireball: Markdown Syntax Documentation](https://daringfireball.net/projects/markdown/syntax). Mais elle comporte des ambiguïtés et ce n’est pas là qu’il faut chercher la « référence ».
Au fil des années, les développeurs et toutes sortes de systèmes d’écriture ont développé ce que l’on appelle des « saveurs » différentes de *Markdown* (“flavours” en anglais). Certaines sont devenues des « standards *de facto* » :
* [CommonMark](https://commonmark.org) — tentative de standardisation, plutôt aboutie et assez bien suivie ;
* [GitHub flavored](https://github.github.com/gfm/) — c’est une extension qu’on rencontre un peu partout, utilisée en particulier par l’éditeur *Typora* ;
* [Markdown Extra](https://en.wikipedia.org/wiki/Markdown#Markdown_Extra) — utilisé dans plusieurs systèmes de gestion de contenu (CMS = “Content Management System”) ;
* [MultiMarkdown](https://fletcherpenney.net/multimarkdown/) — une extension de la définition originelle qui va beaucoup plus loin que celle de *GitHub*, notamment pour tout ce qui est utile aux productions académiques ; moins universellement adoptée que celle de *GitHub* ;
* [Pandoc](http://pandoc.org/) — un génial système de conversion de documents ; il est utilisé par *Typora*, notamment, pour exporter ses documents vers HTML, PDF, Word, etc.
Ceci dit, ces détails concernent surtout les informaticiens et les geeks. Pour l’utilisateur lambda, il suffit de se référer à l’une ou l’autre de ces pages qui présentent l’essentiel de la syntaxe « générale » :
* la syntaxe des fiches d’*Obsidian* est décrite à [cette page](https://help.obsidian.md/How+to/Format+your+notes) du manuel online ;
* [Markdown Reference](https://support.typora.io/Markdown-Reference/) de l’éditeur *Typora* ;
* [Byword Markdown Syntax](https://bywordapp.com/markdown/syntax.html) — l’essentiel, mais il manque cependant :
1. les notes de bas de page ;
2. les tables.
 
<p style="text-align: center;"><a href="https://dr-spinnler.ch"><img src="https://dr-spinnler.ch/myfiles/logos/Olivier-Spinnler.png" class= "signature"/></a></p>
<p style="text-align: center; font-style: italic;">le 18 mars 2022
</p>
 
----------------------------------------------
[[Markdown (domaine)|Markdown]]
#markdown #écriture #informatique