{{backlinks>.}}

====== Markdown ======

Les [[wpfr>wiki|wikis]] et les [[https://pad.codeatlas.cc/gORPBFvfRHmaFWbHPKp6VQ?both|pads]] ((et les plateformes Git)) utilisent généralement la syntaxe [[wpfr>Markdown]] ((Mais il existe aussi d'autres syntaxes de type «\ markdown\ », comme celle de [[wpfr>Dokuwiki]] qu'utilise ce wiki.))

«\ Écrire\ » en Markdown, c'est «\ mélanger\ » du texte en français (ou en anglais, en italien…) et des «\ éléments de **[[#syntaxe]]**\ », pour «\ mettre en page\ », c'est-à-dire générer des éléments [[icn>numerique:web#langage|Html]], et composer une «\ page web\ » simplement. On peut par exemple, générer des [[wpfr>hyperlien|hyperliens]] facilement\ ((voir plus bas)).


===== Syntaxe =====

Par exemple, pour «\ écrire\ » des titres  (1 dièse #)

==== Titre ====

  # À titre d'exemple

Des sous-titres (2 dièses ##)

  ## Sous les titres, encore des titres

==== Liens ====

Des liens ( [le nom du lien] entre crochets [] et (l'adresse du lien) entre parenthèses () ) 

  [lien vers le canard blanc 🦆](https://ddg.gg)

pour générer le lien [[https://ddg.gg|lien vers le canard blanc 🦆]]


==== Liste ====

  * :!: [[https://www.markdownguide.org/cheat-sheet|Liste simplifiée de la syntaxe Markdown]]


Pour découvrir comment ont été rédigées les pages sur [[https://archives.sloyd.work/archive/2022-2023|Sloyd]], cliquer sur le bouton ''[[icn>sloyd:editer#barre_d_outils|Brut]]'' des fichiers ''README.md''. Par exemple, voici la [[https://archives.sloyd.work/archive/2022-2023/raw/branch/main/Kristopher-S/palais/README.md|source]] de cette [[https://archives.sloyd.work/archive/2022-2023/src/branch/main/Kristopher-S/palais/README.md|page]].


===== Moteur =====

On peut écrire en Markdown en connaissant quelques notions de bases pour créer des titres, insérer des images et des liens. Il suffit d'apprendre environ 5 éléments de syntaxe (voir plus haut) et cela suffit à produire des documents sous la forme de [[icn>numerique:web|pages web]].

Pour des usages un peu plus avancés, il faut consulter la [[https://docs.codeberg.org/markdown/|documentation officielle]]. On apprend notamment que le **moteur** de rendu des pages s'appelle [[https://github.com/yuin/goldmark|Goldmark]] et qu'il est basé sur une variante de la syntaxe Markdown nommée [[https://commonmark.org/|Commonmark]]. Plus précisément, il s'agit de la [[https://spec.commonmark.org/0.30|version 3]] de la syntaxe.


Dans la [[https://spec.commonmark.org/0.30|documentation Commonmark]], nous pouvons apprendre dans le détail comment la syntaxe est interprétée. La documentation intègre des « petits moteurs d'évaluation » de la syntaxe, comme [[https://spec.commonmark.org/dingus/?text=%26nbsp%3B%20%26amp%3B%20%26copy%3B%20%26AElig%3B%20%26Dcaron%3B%0A%26frac34%3B%20%26HilbertSpace%3B%20%26DifferentialD%3B%0A%26ClockwiseContourIntegral%3B%20%26ngE%3B%0A|dans cet exemple]] où l'on voit que l'on peut écrire le symbole 3/4 grâce à la syntaxe ''¾''. [[https://spec.commonmark.org/0.30/#example-172|Un autre exemple]] nous montre comment ajouter des éléments de style, comme ici un texte de couleur bleue. Pour tester tous ces exemples, il suffit de cliquer sur le bouton ''Try it''. Une fois que vous avez compris comment ils fonctionnent, vous pouvez intégrer ces nouveaux éléments dans vos propres pages Markdown de la plateforme. Pensez à utiliser la fonction « prévisualisation » qui vous permet de tester ces éléments de syntaxe avant d'enregistrer vos fichiers.