Par Daphné Mathelier, le vendredi 3 février 2023 à 14h00.
Markdown est un langage de balisage dit « léger » – car ne comprenant qu’une dizaine de balises – qui permet de produire des fichiers texte faciles à écrire et à lire. Markdown est un langage ouvert qui s’inscrit dans le mouvement du low tech dont il partage les principaux principes : utilité, accessibilité, durabilité. Pensé à ses débuts en 2004 pour permettre la création simplifiée de pages web et comme intermédiaire entre le langage naturel et le langage HTML, il a été progressivement adopté pour d’autres applications, principalement dans les domaines du développement informatique, de la documentation technique et de la publication académique.
Rédiger en Markdown permet de revenir à l’essentiel (simplicité et durabilité), de se concentrer sur le contenu sémantique d’un texte et de s’émanciper des logiciels complexes et propriétaires dont l’obsolescence est prévisible.
Ce webinaire a pour objectif de présenter la philosophie et la syntaxe Markdown ainsi que plusieurs exemples d’utilisation : prise de notes (Obsidian et Zettlr), édition d’articles (Stylo), de présentations (Marp), de notebooks (Rstudio et Jupyter Notebook), de sites statiques (Hugo)…
Daphné Mathelier est ingénieure d’études au CNRS. Ancienne éditrice scientifique, elle est actuellement responsable du service Humanités numériques de la MSH Mondes et elle participe au déploiement de la plateforme universitaire de données de Nanterre.
Cliquez ici pour télécharger les transparents
Cliquez ici pour les fichiers de démonstration. Cinq fichiers dans l’archive :
- 1. Exemple simple au format MD
- 2. Exemple de présentation avec MARP
- 3. Exemple de présentation avec REVEAL.JS
- 4. Exemple de document RMARKDOWN
- 5. Exemple de notebook avec JUPYTER
Merci aux participants du tuto ! Ci-dessous sont reportées les URL, questions (et réponses) et impressions mentionnées dans le tchat par les participants.
I. Outils et formats
- Pandoc :
https://quarto.org/ …peut produire des cellules / vignettes Rmarkdown, jupyter, reveal.js avec markdown
Un bel exemple : https://gitlab.math.unistra.fr/miti-gt-donnees/DEMO-QUARTO
pandoc exporte en JATS
export de md vers docx est possible, et de rmd vers docx aussi ; export de base dans rstudio
- Stylo
les métadonnées : Dans l’interface de Stylo elles sont présentées à part, mais en principe dans un document rédigé en Pandoc Markdown les métadonnées sont intégrées au début du document. Stylo est plutôt l’exception
Il est prévu que Stylo devienne collaboratif – édition simultanée (annoncée). Avez-vous connaissance d’une date ?
- Joplin
Que pensez-vous de Joplin (outil fonctionnant aussi avec markdown ?
Oui Joplin également à rajouter dans les outils de notes MD :
… une très bonne alternative à evernote etc
… open source et communauté très active
Joplin a un connecteur vers owncloud/nextcloud/sharedocs
[time 01:19:00] Joplin est une solution ‘ouverte’, notons que Obsidian n’est pas open source.
- Obsidian
Que deviennent les liens entre notes Obsidian quand on exporte ?
il y a un plugin pour les convertir en liens markdown
Quelqu’un a créé un programme Python qui permet de convertir un répertoire de notes Obsidian en site web, avec du coup les liens fonctionnels :
https://github.com/obsidian-html/obsidian-html
- jupyterlite et serveur
… un serveur local est lancé par défaut, boucle sur le réseau local de votre ordinateur. Il y a tout de même un token généré pour s’assurer que sur un poste multi-utilisateurs les autres n’y aient pas accès
jupyterlite est une solution (en développement) sans serveur local ou distant c’est votre navigateur qui fait tourner le tout (interface et interpréteurs)
https://jupyterlite.readthedocs.io/en/latest/
https://jupyterlite.readthedocs.io/en/latest/try/lab
II. Remarques diverses
- IR* Huma-Num :
https://gitlab.huma-num.fr/gitlab-pages
- [time 00:42:00] Au sujet de la visualisation des mots clefs sous forme de nuage : “C’est un peu gadget” : pas tout à fait d’accord 🙂 https://www.arthurperret.fr/blog/2022-02-13-a-quoi-sert-une-vue-graphe.html
- est-ce qu’il sera possible un moment de faire un rapide comparatif entre Latex et markdown (notamment pour la rédaction des documents scientifiques) ?
… ça a l’air chouette ! Ca me fait penser un peu à overleaf avec LaTeX, mais ça a l’air encore plus “user friendly”
… [time 01:48:00]
- Un atelier Markdown animé pour le groupe SO-MATE au mois de mai 2022. le dépôt de l’atelier :
https://git.univ-pau.fr/jrabaud001/so-mate_atelier_markdown_carnets
La séance s’est tenue sur la plateforme Big Blue Button de l’EHESS que nous remercions pour son soutien.