RM 01 Md

Introduction à Markdown

1. Petite histoire du format Markdown

Markdown a été créé en 2004 par John Gruber avec l’aide d’Aaron Swartz.
Leur idée : un format de texte facile à lire et à écrire en brut, mais qui puisse être converti en HTML pour le web.

Le succès a été immédiat car Markdown combine : - la simplicité du texte brut (lisible sans outil spécial), - la puissance du HTML (titres, listes, liens, images).

Aujourd’hui, il existe plusieurs “dialectes” de Markdown (CommonMark, GitHub Flavored Markdown, etc.), mais la philosophie reste la même.

2. Qui s’en sert et pourquoi ?

Utilisateurs principaux

• Développeurs : documentation de projets sur GitHub, GitLab, etc.
  
• Écrivains et journalistes : rédaction d’articles, notes et blogs.
  
• Enseignants et étudiants : supports de cours, rapports, fiches.
  
• Gestion de projet : todo-lists, wiki internes, notes partagées.

Pourquoi Markdown est pertinent ?

• Lisible partout : un simple fichier .md fonctionne dans n’importe quel éditeur.
  
• Portable : pas lié à un logiciel propriétaire.
  
• Rapide : pas besoin de cliquer dans des menus, tout se fait avec quelques caractères.
  
• Compatible : se convertit facilement en HTML, PDF, DOCX, etc.
  
• Collaboratif : idéal pour le travail en équipe (repos Git, plateformes en ligne).

3. Petit manuel d’écriture en Markdown

Voici les bases les plus utiles.
(Tu peux tester dans n’importe quel éditeur Markdown : VSCode, Obsidian, MarkText, Ghostwriter…)

3.1. Paragraphes

Un simple retour à la ligne ne crée pas de nouveau paragraphe.
Il faut laisser une ligne vide entre deux paragraphes.

Ceci est un premier paragraphe.

Ceci est un deuxième paragraphe.

3.2. Titres

On utilise le signe #. Plus il y en a, plus le titre est petit.

# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3

3.3. Texte en gras, italique et barré

**gras**
*italique*
~~barré~~

Affichage : gras, italique, barré

3.4. Listes

• Listes à puces :

- élément 1
- élément 2
  - sous-élément

• Listes numérotées :

1. premier
2. deuxième
3. troisième

3.5. Liens et images

• Lien :

[Texte du lien](https://example.com)

• Image :

![Texte alternatif](https://example.com/image.png)

3.6. Citations

On utilise > en début de ligne.

> Ceci est une citation.

3.7. Code

• Dans une phrase :

Voici du `code` inline.

• Bloc de code :

```Javascript
function hello() {
console.log("Hello Markdown !");
}
```

3.8. Tableaux

| Nom   | Âge | Ville   |
|-------|-----|---------|
| Alice |  24 | Paris   |
| Bob   |  30 | Lyon    |

Affichage :

3.9. Séparateurs

---

Affiche une ligne horizontale.

Conclusion

Markdown est un format simple, universel et puissant. Il permet d’écrire des textes lisibles immédiatement et convertibles en documents riches. Sur Hypatie, il permet d’écrire simplement des documents qui seront automatiquement convertis en pages html.