Session 16 : Notes du coach
Objectif de cette session
À la fin de cette session, un ninja sait :
- Créer un fichier
.mdet 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.mdcomplet 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.iooustackedit.io. Vérifie que la preview est visible au projecteur. - Un fichier de démo prêt. Fais un
demo.mdavec 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
.mden 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.
« Quelle est la différence entre Markdown et HTML ? »
HTML est fait pour les navigateurs : compliqué, avec des tags comme <h1>, <p>, <a href="">. Markdown est fait pour les humains : simple, lisible comme du texte. Sous le capot, Markdown est converti en HTML. Mais tu ne dois jamais écrire de HTML.
« Je peux utiliser Markdown dans Word ou Google Docs ? »
Pas directement. Word utilise sa propre mise en forme. Mais tu peux écrire du Markdown dans un fichier .md et le convertir plus tard en PDF, en HTML ou en Word. Des outils comme Pandoc le font.
« Pourquoi ça s’appelle Markdown ? » C’est un jeu de mots sur « markup » (langage de balisage). Markdown = « markup » mais en « down » : plus simple, moins de tracas.
Indices pour Stretch et Expert
Stretch : listes imbriquées : Deux espaces d’indentation suffisent pour une sous-liste. Quatre espaces marchent aussi. Être cohérent compte plus que le nombre d’espaces.
Expert : Markdown dans Git :
Combine cette session avec la session 11 : fais un README.md, mets-le dans un dépôt Git et committe-le. Ton premier document Markdown sous gestion de versions.
Pièges pratiques
Oublier la ligne vide avant une liste. Une liste doit être précédée d’une ligne vide, sinon Markdown la colle au paragraphe précédent. C’est la plus grande source de « pourquoi mon Markdown ne marche pas ? »
Des espaces dans la mise en forme.
** gras **ne marche pas : pas d’espaces entre les astérisques et le texte.**gras**oui. Ça demande un temps d’adaptation pour ceux qui ont l’habitude de Word.Aligner les tableaux. Le
:dans la ligne de séparation (:---,:---:,---:) détermine l’alignement à gauche/au centre/à droite. Une faute très courante, c’est d’oublier ce:et puis de se plaindre que le tableau ne s’aligne pas.