27 Markdown : balisage léger pour la recherche
27.1 Pourquoi apprendre le Markdown
- C’est extrêmement simple.
- C’est une méthode de balisage de texte lisible par les humains et par certains logiciels qui sont capables ensuite de :
- Faire de belles visualisations du fichier
- Exporter vers d’autres formats (html, pdf, MS Word,…)
- C’est devenu une sorte de standard dans beaucoup de domaines de la recherche.
27.2 Quels sont les codes de balisage minimum à connaître ?
- Les balisages de niveaux de titre
- Faire des liens URL
- Faire des listes à puces ou numérotées
- Faire des gras et des italiques
27.3 Exemples de logiciels qui utilisent Markdown
27.3.1 Obsidian pour prendre des notes
- Voir Obsidian.md
27.3.2 Zettlr pour rédiger
- Zettlr : Logiciel simple, permettant de rédiger au format Markdown et ensuite, en fournissant une bibliographie et un style bibliographique, de produire différents formats de documents (PDF, html, etc.).
- Fichier > Préférences > Préférences > Exporter : Fichier de références bibliographiques
- Un fichier peut être exporté de Zotero (Exporter > format CSL JSON ou BibTeX) ou bien être mis à jour automatiquement avec l’extension Zotero Better BibTeX.
- Fichier > Préférences > Préférences > Exporter : Fichier de références bibliographiques + Fichier de format de références bibliographiques CSL
- Un fichier de style peut être trouvé sur le site Zotero/styles
- Possibilité d’avoir un système de notes liées (non testé par moi).
- Fichier > Préférences > Préférences > Exporter : Fichier de références bibliographiques
27.3.3 Quarto pour rédiger et diffuser
Ce manuel a été conçu avec l’extension Quarto, installée dans le logiciel de statistique RStudio. Quarto a remplacé les projets RMarkdown et RBookdown.
Il permet de rédiger au format Markdown.
Avec des références issues de Zotero.
Avec un système de renvois entre sections.
Avec la possibilité d’exécuter du code R ou autre pour faire des graphiques (exemple).
Qui peut générer en un (1) clic : un site web, un fichier PDF, un fichier Word et un fichier ePub.
- Le site web peut ensuite être envoyé facilement sur GitHub.io (en 3 clics).
27.4 Autres systèmes utilisant Markdown
- ObservableHQ pour produire de belles infographies
- Documenter les codes sources de GitHub