Markdown pour l’enseignant

LMDBT - Le blog

Markdown pour l’enseignement : présentation d’outils pour l’exploiter dans ses enseignements

Publié le : 25/05/2023
Mis à jour le : 10/09/2023

Introduction

Markdown est un langage de balisage léger qui est facile à apprendre, mais qui demande, malgré tout, un petit investissement pour être pris en main.
Coder en Markdown peut s’apprendre rapidement grâce à ce tutoriel et on peut apprécier son potentiel grâce à cette présentation. Plus d’info ICI.

Je présente dans ce billet des outils que j’utilise assez fréquemment depuis quelques mois maintenant.

Des outils pour passer de Markdown en HTML

CodiMD sur AppsÉducation

CodiMD est un éditeur collaboratif, en temps réel et multiplateforme, de notes au format Markdown. Il permet d’éditer à plusieurs et en simultané un document en Markdown. La publication au format HTML se fait de façon instantanée.

Un tutoriel écrit est disponible ICI.

Les plus :

• Facile d’utilisation
• Aperçu et publication instantanée
• Modification à plusieurs en simultané
• Intégration des images par un simple glissé-déposé

Les moins :

• Inscription nécessaire
• Modification du style pas simple
• Export en HTML peu esthétique avec des $maths$

Remarque
L’intégration et l’hébergement des images par CodiMD par glissé-déposé le rend très intéressant comme outil pour composer son code avant de l’exploiter sur d’autres outils web.

MD2HTML sur La Forge

MD2HTML est une appli web qui permet de transformer votre document Markdown en un document HTML avec un style associé.

La page HTML peut directement être partagée sur Pronote par exemple auprès des élèves.

L’intérêt du HTML est le fait qu’il s’adapte au support sur lequel il est visionné (ordinateur, téléphone, tablette…)

Les plus :

• Pas d’inscription
• Aperçu immédiat
• Enregistrement du document Markdown et de la page HTML sur l’ordinateur.
• Interprétation du code HTML et prise en charge des favicons
• Esthétique du $mode maths$ conservée lors de l’export en HTML

Les moins :

• Pas d’hébergement : c’est à vous d’héberger la page ou de la partager directement
• Pas de sauvegarde automatique
• Styles limités
• Les images doivent être en ligne
• Prend en charge uniquement les images hébergées en ligne

Remarque
Pour les images, vous pouvez générer votre code dans CodiMD puis copier-coller ce dernier dans MD2HTML. \(😉\)

Les outils pour passer de Markdown en PDF

Depuis le navigateur

Une fois l’export en HTML effectué, il est possible d’enregistrer la page HTML directement au format PDF en l’imprimant dans un document PDF.

Les plus :

• Facile et disponible sur tout navigateur

Les moins :

• Mise en page "subie" (celle de son code CSS)
• Rendu à faible esthétisme

En utilisant A4

Ce site (sur Gitlab ou sur Github) vous propose un outil pour créer automatiquement à partir d’un fichier en Markdown une page HTML à imprimer en A4, avec :

• Un calcul automatique de la taille de police optimale pour que le contenu du document tienne sur le nombre de pages choisi, sans dépassement.
• La possibilité de choisir le nombre de pages, le nombre de colonnes, une impression en format paysage ou portrait
• La possibilité de répéter plusieurs fois le même contenu sur les différentes pages ou colonnes
• Un respect automatique des règles typographiques françaises sur les espaces insécables

Les plus :

• Facile et pratique d’utilisation
• Adapté pour faire plusieurs copies sur une même page
• Importation d’un style CSS facilitée

Les moins :

• Mise en page des images qui demande l’ajout d’un style
• Prend en charge uniquement les images hébergées en ligne

De Markdown vers une présentation

"Vite un diapo" sur La Forge

Les plus :

• Rendu rapide et esthétique
• Facile d’utilisation
• Intégration d’un $mode maths$
• "Stylisable" en code CSS ou avec Mermaid

Les moins :

• Mise en page délicate des images qui doivent être hébergées en ligne au préalable

L’exemple ci-dessous :

a été obtenu avec le code disponible ici

CodiMD sur AppsÉducation

CodiMD intègre un mode présentation.

    Commencer le document par :
    - - -
    type: slide
    slideOptions:
    transition: slide
    - - -

    Le séparateur de diapositive est - - -

Plus d’information ICI.

Rstudio (utilisateur avancé ?)

Les plus :

• De nombreux modèles disponibles
• Intégration de graphiques et figures codées en R
• Style paramétrable

Les moins :

• Un peu "compliqué" au premier abord
• Une grosse application (R + Rstudio) si on fait "juste" des présentations
• Peu d’animations disponibles

Un outil pour passer de Markdown en carte mentale

myMarkmap

Une application en ligne pour concevoir et partager à l’aide d’un simple lien une carte mentale.

Applications sur ordinateur et téléphone

Visual Studio Code (ordinateur)

"Visual Studio Code est un éditeur de code extensible développé par Microsoft pour Windows, Linux et macOS. Les fonctionnalités incluent la prise en charge du débogage, la mise en évidence de la syntaxe, la complétion intelligente du code, les snippets, la refactorisation du code et Git intégré."
Wikipédia

Au-delà d’avoir un aperçu en simultané de son document Markdown sur sa machine, VS Code permet aussi d’éditer en d’autres langages (Python, GnuOctave, R, \(\LaTeX\)…).

La prise en charge de débogage est vraiment intéressante également.

Obsidian (téléphone)

Une grande partie de ce compte rendu a été tapée sur cette application sous Android.

Aperçu en direct. Enregistrement sur un compte et documents partageables et récupérables en ligne : aussi simple qu’efficace !