https://python.coderdojohasselt.be/fr/sessions/git/16-markdown/index.htmlTu connais peut-être HTML par internet : <h1>, <p>, <a>. Mais pour des notes et de la documentation, HTML demande beaucoup trop de frappe. C’est pour ça que Markdown existe. Markdown est un mini-langage que tu écris en texte normal. Ça reste lisible sans devoir d’abord le convertir. Et d’une seule pression sur un bouton, ça devient du HTML propre : des titres, des listes, des liens, des tableaux. Dans cette session, tu apprends toute la base de Markdown. À la fin, tu écriras des notes qui ont l’air professionnelles, sur GitHub, dans Obsidian, ou dans n’importe quel autre programme qui comprend Markdown.Hugofr-BEhttps://python.coderdojohasselt.be/fr/sessions/git/16-markdown/mentor-notes/index.htmlMon, 01 Jan 0001 00:00:00 +0000https://python.coderdojohasselt.be/fr/sessions/git/16-markdown/mentor-notes/index.htmlObjectif de cette session À la fin de cette session, un ninja sait : Créer un fichier .md et l’ouvrir dans un éditeur. Écrire des titres, des paragraphes, du gras, de l’italique et du texte barré. Faire des listes numérotées et non numérotées (y compris des listes imbriquées). Faire des liens externes et des liens internes. Construire un tableau avec des colonnes et de l’alignement. Utiliser des blocs de code avec du syntax highlighting. Écrire un README.md complet qui combine titres, listes, liens et code. Préparation (30 min avant la session) Un éditeur avec preview Markdown prêt. VS Code est idéal (preview intégrée avec Ctrl+Shift+V). Obsidian marche aussi. Si rien n’est disponible : utilise un éditeur en ligne comme dillinger.io ou stackedit.io. Vérifie que la preview est visible au projecteur. Un fichier de démo prêt. Fais un demo.md avec des exemples de chaque feature Markdown (titre, liste, lien, tableau, bloc de code). Utilise-le pour montrer en live à quoi ressemble Markdown en texte brut et en preview. Thonny comme fallback. Si les ninjas n’ont rien d’autre : Thonny ouvre les fichiers .md en texte brut. Ils peuvent apprendre la syntaxe sans preview ; la preview est agréable mais pas essentielle. Répartition du temps (3 heures) Temps Activité 0:00 à 0:10 C’est quoi Markdown ? Où est-ce que tu le rencontres ? (GitHub, notes, ce site) 0:10 à 0:30 Projecteur : démo (montrer chaque feature en live et afficher la preview) 0:30 à 1:00 En autonomie : titres, mise en forme, listes 1:00 à 1:15 Pause 1:15 à 1:45 Projecteur : liens, images, tableaux, blocs de code 1:45 à 2:30 En autonomie : écrire un README complet 2:30 à 2:45 Showcase : montre ton README (texte brut + preview) 2:45 à 3:00 Clôture, à emporter Questions fréquentes « Je dois apprendre Markdown par cœur ? » Non. La plupart des éditeurs ont des boutons pour la mise en forme (comme Word). Mais connaître la syntaxe est pratique : tu tapes plus vite, et sur des plateformes comme GitHub tu n’as que le texte brut.