📝 Fichier Markdown

Les fichiers Markdown (.md) permettent d’écrire du texte structuré, lisible à la fois par les humains et les machines. Ils sont souvent utilisés pour la documentation, les notes, ou les fichiers README.

---

Créer un fichier Markdown dans PyCharm

1. Ouvrir un projet dans PyCharm (ou en créer un nouveau).
2. Dans l’arborescence à gauche, cliquer-droit sur le dossier où créer le fichier.
3. Choisir New > File.
4. Nommer le fichier avec l’extension .md, par exemple notes.md, puis appuyer sur ⏎.
5. Un nouvel onglet s’ouvre avec un éditeur Markdown.

---

Prévisualiser le fichier Markdown

1. Dans la barre d’outils du haut, cliquer sur l’icône de Editor and Preview (des lignes et un rectangle) dans la barre d’outils en haut.
2. PyCharm affiche à gauche le texte brut (code source), et à droite le rendu visuel.

---

Écrire du contenu Markdown

1. Taper du texte dans le fichier (à gauche) en utilisant la syntaxe Markdown.
2. Ajouter des titres, des listes, des liens, des images ou des blocs de code (voir exemples ci-dessous).
3. Le rendu visuel à droite se met à jour automatiquement.

Exemple de contenu Markdown

# Mes notes

Voici une **liste de tâches** :

- Lire la documentation
- Écrire un `README.md`
- Apprendre Markdown

## Exemple de lien

[Doc](https://www.markdownguide.org)

## Exemple de code

```python
def dire_bonjour(nom):
print(f"Bonjour, {nom}!")
```

Résultat affiché

Mes notes

Voici une liste de tâches :

• Lire la documentation
• Écrire un README.md
• Apprendre Markdown

Exemple de lien

Doc

Exemple de code

def dire_bonjour(nom):
    print(f"Bonjour, {nom}!")

---

Faire une trace

Pour faire le tableau d'une trace de l'exécution d'un bout de code, il suffit d'utiliser des | pour séparer les colonnes et - pour créer une ligne horizontale.

Exemple de tableau de trace

| # ligne | a | b  | affichage |
|---------|---|----|-----------|
| 1       | 7 |    |           |
| 2       | 7 | 14 |           |
| 3       | 7 | 14 | salut 14  |

(vous pouvez copier-coller ce gabarit dans votre fichier Markdown)

Résultat affiché

# ligne	a	b	affichage
1	7
2	7	14
3	7	14	salut 14

---

Astuces

• Utiliser README.md dans un projet GitHub permet d'afficher automatiquement la description du projet sur la page principale.
• Pour insérer des images locales, utiliser la syntaxe ![texte alternatif](chemin/vers/image.png).

---