Tuto MATé2
2023-02-03
https://mate-shs.cnrs.fr/actions/tutomate/tuto51-markdown-mathelier/
Markdown pour les SHS - MATE-SHS
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.
La séance se tiendra en visioconférence sur la plateforme Big Blue Button de l’EHESS. Il suffira de se connecter à partir de 13h30 à l’adresse suivante : https://bbb.ehess.fr/b/dam-8z7-men-yyv (pas d’inscription préalable). Les séances sont enregistrées mais la liste des présents et les commentaires sur le tchat ne sont pas visibles sur le replay du Tuto.
Les instructions et conseils de connexion sont visibles en suivant le lien.
![[../../DATA/pdfs/Tuto51_MD_TutoMate-support_compressed.pdf]]
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.
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
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 ?
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.
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
… 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)
Historique Gruber 2004