Introduction à Markdown

Objectif: Apprendre à utiliser le langage pour mettre en forme du texte

Markdown 101

Qu'est-ce que Markdown ?

  • Markdown est un langage de balisage léger.
  • Il permet de formater du texte en toute simplicité.
  • Lisible en texte brut et facilement convertible en HTML.
  • Créé pour être facile à lire et à écrire.
Markdown 101

L'histoire de Markdown

  • Créé en 2004 par John Gruber en collaboration avec Aaron Swartz
  • Objectif : proposer un format d'écriture simple pour le web
  • Markdown a vite été adopté sur le web et dans le monde scientifique
Markdown 101

Où est utilisé Markdown ?

  • Documentation technique (ex. GitHub, GitLab, ReadTheDocs)
  • Éditeurs de texte (Typora, Obsidian, VS Code)
  • Blogs (Jekyll, Hugo, Hexo)
  • Notes personnelles
  • Courriels ou présentations (comme celle-ci !)
Markdown 101

Syntaxe de base

Titres

# Titre 1
## Titre 2
### Titre 3

Texte

**Gras**, *Italique*, ~~Barré~~

Listes

- Élément
- Élément
  - Sous-élément
Markdown 101

Syntaxe (suite)

Liens

[Cégep de Rosemeont](https://crosemont.qc.ca)

Images

![Texte alternatif](image.png)

Code

`code inline`

```python
print("Bonjour")
``
Markdown 101

Différentes normes Markdown

Markdown "classique"

  • La version originale de John Gruber

GitHub Flavored Markdown (GFM)

  • Extensions pour GitHub :
    • Tables
    • Cases à cocher
    • Blocs de code avec langage

CommonMark

  • Spécification standardisée pour uniformiser Markdown
Markdown 101

En résumé

✅ Facile à apprendre
✅ Compatible partout
✅ Parfait pour écrire des documents techniques

Prêt à écrire en Markdown ?

Markdown 101