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

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).

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