27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
## La syntaxe markdown
|
||
|
||
La syntaxe markdown est très bien documentée sur le web :
|
||
|
||
- La documentation « officielle » est disponible sur le site personnel d'un des
|
||
concepteurs de la syntaxe : <https://daringfireball.net/projects/markdown/>
|
||
[@gruberMarkdown2004].
|
||
- Le site *flus* propose Une documentation en français et très claire :
|
||
<https://flus.fr/carnet/markdown.html> [@fressinaudGuideMarkdown2022].
|
||
- Il y a plusieurs variantes (ou extensions) de la syntaxe et un site essaie de
|
||
proposer un standard. Il met à disposition un tutoriel interactif :
|
||
<https://commonmark.org/help/> [@commonmarkCommonMark].
|
||
- Arthur Perret a traduit en français ce même tutoriel, disponible sur sa page
|
||
expliquant ce qu'est markdown :
|
||
<https://www.arthurperret.fr/cours/markdown.html> [@perretMarkdown2022].
|
||
|
||
Pour les tableaux, il est fortement conseillé :
|
||
|
||
- D'utiliser un générateur, par exemple
|
||
<https://www.tablesgenerator.com/markdown_tables>.
|
||
- Ou de disposer dans son éditeur d'un générateur de tableaux.
|
||
|
||
Le plus souvent les fichiers contenant du markdown ont pour extension `.md`,
|
||
mais c'est une convention. Rien n'interdit d'utiliser d'autres extensions comme
|
||
`.mkdn` ou `.markdown`, pour autant que l'éditeur que vous utilisez les
|
||
reconnaissent comme du markdown.
|