Syntaxe des listes

Les listes sont un moyen important d'organiser l'information. Markdown prend en charge les listes ordonnées, non ordonnées, les listes imbriquées et les listes de tâches.

Listes non ordonnées

Syntaxe de base

Utilisez -, * ou + pour créer des listes non ordonnées :

markdown

- Élément 1
- Élément 2
- Élément 3

* Élément 1
* Élément 2
* Élément 3

+ Élément 1
+ Élément 2
+ Élément 3

Rendu :

Élément 1
Élément 2
Élément 3

Conseils sur le choix du symbole

Symbole	Particularité	Scénario recommandé
`-`	Le plus courant, concis	Généralement recommandé
`*`	Cohérent avec l'emphase	Pour la cohérence de style
`+`	Rarement utilisé	Pour une distinction spéciale

Astuce : Gardez la cohérence du symbole dans tout le document.

Listes ordonnées

Syntaxe de base

Utilisez des chiffres suivis d'un point pour créer des listes ordonnées :

markdown

1. Premier élément
2. Deuxième élément
3. Troisième élément

Rendu :

Premier élément
Deuxième élément
Troisième élément

Numérotation

La valeur réelle du chiffre n'a pas d'importance : Markdown générera automatiquement la séquence correcte :

markdown

1. Premier élément
3. Deuxième élément
8. Troisième élément

Rendu :

Premier élément
Deuxième élément
Troisième élément

Numéro de départ

Vous pouvez spécifier le numéro de départ :

markdown

3. Troisième élément
4. Quatrième élément
5. Cinquième élément

Rendu :

Troisième élément
Quatrième élément
Cinquième élément

Listes imbriquées

Imbrication de base

Utilisez l'indentation (2 à 4 espaces) pour créer des listes imbriquées :

markdown

- Élément niveau 1.1
  - Élément niveau 2.1
  - Élément niveau 2.2
- Élément niveau 1.2
  - Élément niveau 2.3
    - Élément niveau 3.1
    - Élément niveau 3.2
  - Élément niveau 2.4

Rendu :

Élément niveau 1.1
- Élément niveau 2.1
- Élément niveau 2.2
Élément niveau 1.2
- Élément niveau 2.3
  - Élément niveau 3.1
  - Élément niveau 3.2
- Élément niveau 2.4

Imbrication mixte

Les listes ordonnées et non ordonnées peuvent être imbriquées :

markdown

1. Élément ordonné 1
   - Sous-élément non ordonné 1.1
   - Sous-élément non ordonné 1.2
2. Élément ordonné 2
   1. Sous-élément ordonné 2.1
   2. Sous-élément ordonné 2.2
      - Sous-sous-élément non ordonné 2.2.1
      - Sous-sous-élément non ordonné 2.2.2

Rendu :

Élément ordonné 1
- Sous-élément non ordonné 1.1
- Sous-élément non ordonné 1.2
Élément ordonné 2
1. Sous-élément ordonné 2.1
2. Sous-élément ordonné 2.2
  - Sous-sous-élément non ordonné 2.2.1
  - Sous-sous-élément non ordonné 2.2.2

Contenu multi-paragraphes dans les listes

Suite de paragraphe

Incluez plusieurs paragraphes dans un élément de liste :

markdown

1. Premier élément

   Ceci est le deuxième paragraphe du premier élément. Indentez pour qu'il reste dans l'élément de liste.

2. Deuxième élément

   Ceci est le deuxième paragraphe du deuxième élément.
   
   Ceci est le troisième paragraphe du deuxième élément.

3. Troisième élément

Rendu :

Premier élément
Ceci est le deuxième paragraphe du premier élément. Indentez pour qu'il reste dans l'élément de liste.
Deuxième élément
Ceci est le deuxième paragraphe du deuxième élément.
Ceci est le troisième paragraphe du deuxième élément.
Troisième élément

Blocs de code

Incluez des blocs de code dans une liste :

markdown

1. Installer les dépendances

   ```bash
   npm install express

Créer le serveur

javascript

const express = require('express');
const app = express();

Démarrer le serveur


### Citations

Incluez des citations dans une liste :

```markdown
1. Préparation

   > Assurez-vous d'avoir suffisamment d'espace disque
   > Au moins 10 Go sont recommandés

2. Démarrer l'installation

Listes de tâches

Syntaxe de base

Utilisez - [ ] pour les tâches à faire, - [x] pour les tâches terminées :

markdown

- [x] Tâche terminée
- [ ] Tâche à faire
- [x] Autre tâche terminée
- [ ] Élément à faire

Rendu :

[x] Tâche terminée
[ ] Tâche à faire
[x] Autre tâche terminée
[ ] Élément à faire

Listes de tâches imbriquées

markdown

- [x] Planification du projet
  - [x] Analyse des besoins
  - [x] Recherche technique
  - [ ] Conception du prototype
- [ ] Phase de développement
  - [ ] Développement frontend
    - [x] Mise en page
    - [ ] Fonctionnalités interactives
  - [ ] Développement backend
    - [ ] Conception de l'API
    - [ ] Conception de la base de données
- [ ] Phase de tests

Rendu :

[x] Planification du projet
- [x] Analyse des besoins
- [x] Recherche technique
- [ ] Conception du prototype
[ ] Phase de développement
- [ ] Développement frontend
  - [x] Mise en page
  - [ ] Fonctionnalités interactives
- [ ] Développement backend
  - [ ] Conception de l'API
  - [ ] Conception de la base de données
[ ] Phase de tests

Erreurs courantes et solutions

1. Indentation incorrecte

markdown

❌ Erreur : Indentation incohérente
- Élément 1
  - Sous-élément 1.1
    - Sous-élément 1.2  ← Erreur d'indentation

✅ Correct : Indentation cohérente
- Élément 1
  - Sous-élément 1.1
  - Sous-élément 1.2

2. Lignes vides entre les éléments

markdown

❌ Erreur : Lignes vides inutiles cassent la liste
- Élément 1

- Élément 2  ← Cela crée deux listes séparées

✅ Correct : Éléments consécutifs
- Élément 1
- Élément 2

3. Espace manquant après le numéro

markdown

❌ Erreur :
1.Premier élément  ← Espace manquant
2.Deuxième élément

✅ Correct :
1. Premier élément
2. Deuxième élément

Cas particuliers

Échapper les symboles de liste

Si vous souhaitez afficher les symboles de liste en début de ligne sans créer de liste :

markdown

\- Ceci n'est pas un élément de liste
\* Ceci n'est pas un élément de liste
\1. Ceci n'est pas un élément de liste ordonnée

Rendu :

- Ceci n'est pas un élément de liste * Ceci n'est pas un élément de liste \1. Ceci n'est pas un élément de liste ordonnée

Code dans les éléments de liste

markdown

- Installer `npm install nom-du-paquet`
- Lancer `npm start`
- Visiter `http://localhost:3000` dans votre navigateur

Rendu :

Installer npm install nom-du-paquet
Lancer npm start
Visiter http://localhost:3000 dans votre navigateur

Liens dans les éléments de liste

markdown

- [GitHub](https://github.com) – Plateforme d'hébergement de code
- [Stack Overflow](https://stackoverflow.com) – Site de questions/réponses
- [MDN](https://developer.mozilla.org) – Documentation développeur

Rendu :

GitHub – Plateforme d'hébergement de code
Stack Overflow – Site de questions/réponses
MDN – Documentation développeur

Bonnes pratiques

1. Garder la cohérence

markdown

✅ Recommandé : Toujours utiliser les tirets
- Élément A
- Élément B
- Élément C

❌ Non recommandé : Mélange de symboles
- Élément A
* Élément B
+ Élément C

2. Utiliser l'imbrication à bon escient

markdown

✅ Recommandé : Imbrication modérée
- Fonctionnalités principales
  - Gestion des utilisateurs
  - Gestion du contenu
- Fonctionnalités annexes
  - Journalisation
  - Sauvegarde des données

❌ Non recommandé : Imbrication trop profonde
- Fonctionnalités
  - Fonctionnalités principales
    - Fonctionnalités de base
      - Fonctionnalités fondamentales  ← Trop profond

3. Organiser sémantiquement

markdown

✅ Recommandé : Regrouper logiquement
## Outils de développement
- Éditeur de code
- Contrôle de version
- Outils de débogage

## Outils de conception
- Prototypage
- Édition d'image
- Design UI

❌ Non recommandé : Pas de regroupement logique
- Éditeur de code
- Prototypage
- Contrôle de version
- Édition d'image

Sortie HTML

Les listes Markdown sont converties en HTML :

markdown

- Élément 1
- Élément 2

Converti en :

html

<ul>
  <li>Élément 1</li>
  <li>Élément 2</li>
</ul>

markdown

1. Élément 1
2. Élément 2

Converti en :

html

<ol>
  <li>Élément 1</li>
  <li>Élément 2</li>
</ol>

Exemples pratiques

Liste de courses

markdown

## Liste de courses du jour

### Produits quotidiens
- [ ] Shampoing
- [ ] Dentifrice
- [x] Serviette

### Alimentation
- [ ] Lait
- [ ] Pain
- [x] Œufs
- [ ] Fruits
  - [ ] Pomme
  - [x] Banane
  - [ ] Orange

Plan d'étude

markdown

## Plan d'étude du mois

1. **Semaine 1** : Bases
   - [x] Lire les chapitres 1-3 du tutoriel
   - [x] Faire les exercices 1-10
   - [ ] Regarder les vidéos 1-5

2. **Semaine 2** : Projet pratique
   - [ ] Créer un projet simple
   - [ ] Implémenter les fonctionnalités de base
   - [ ] Ajouter du style

3. **Semaine 3** : Contenu avancé
   - [ ] Apprendre les fonctionnalités avancées
   - [ ] Optimiser les performances du projet
   - [ ] Écrire des tests

4. **Semaine 4** : Révision
   - [ ] Organiser les notes
   - [ ] Préparer le projet final
   - [ ] Revoir les points clés

Liste des fonctionnalités d'API

markdown

## Points d'accès API

### Gestion des utilisateurs
1. `GET /api/users` – Obtenir la liste des utilisateurs
   - Prend en charge la pagination
   - Prend en charge le filtrage par recherche
   
2. `POST /api/users` – Créer un nouvel utilisateur
   - Nécessite des droits administrateur
   - Valider l'unicité de l'email
   
3. `PUT /api/users/:id` – Mettre à jour les infos utilisateur
   - Les utilisateurs ne peuvent modifier que leurs propres infos
   - Les admins peuvent modifier n'importe quel utilisateur

### Gestion du contenu
- `GET /api/posts` – Obtenir la liste des articles
- `POST /api/posts` – Créer un nouvel article
- `DELETE /api/posts/:id` – Supprimer un article

Syntaxes associées

Listes de tâches – Fonctions de tâches avancées
Listes de définitions – Définitions de termes
Syntaxe des citations – Citer du texte
Syntaxe du code – Mise en forme du code

Pratique

Créez les types de listes suivants :

Une structure de projet imbriquée sur trois niveaux
Une liste d'étapes techniques avec exemples de code
Une liste complexe mélangeant éléments ordonnés et non ordonnés
Une checklist de projet avec statuts de tâches

Syntaxe des listes ​

Listes non ordonnées ​

Syntaxe de base ​

Conseils sur le choix du symbole ​

Listes ordonnées ​

Syntaxe de base ​

Numérotation ​

Numéro de départ ​

Listes imbriquées ​

Imbrication de base ​

Imbrication mixte ​

Contenu multi-paragraphes dans les listes ​

Suite de paragraphe ​

Blocs de code ​

Listes de tâches ​

Syntaxe de base ​

Listes de tâches imbriquées ​

Erreurs courantes et solutions ​

1. Indentation incorrecte ​

2. Lignes vides entre les éléments ​

3. Espace manquant après le numéro ​

Cas particuliers ​

Échapper les symboles de liste ​

Code dans les éléments de liste ​

Liens dans les éléments de liste ​

Bonnes pratiques ​

1. Garder la cohérence ​

2. Utiliser l'imbrication à bon escient ​

3. Organiser sémantiquement ​

Sortie HTML ​

Exemples pratiques ​

Liste de courses ​

Plan d'étude ​

Liste des fonctionnalités d'API ​

Syntaxes associées ​

Pratique ​

Syntaxe des listes

Listes non ordonnées

Syntaxe de base

Conseils sur le choix du symbole

Listes ordonnées

Syntaxe de base

Numérotation

Numéro de départ

Listes imbriquées

Imbrication de base

Imbrication mixte

Contenu multi-paragraphes dans les listes

Suite de paragraphe

Blocs de code

Listes de tâches

Syntaxe de base

Listes de tâches imbriquées

Erreurs courantes et solutions

1. Indentation incorrecte

2. Lignes vides entre les éléments

3. Espace manquant après le numéro

Cas particuliers

Échapper les symboles de liste

Code dans les éléments de liste

Liens dans les éléments de liste

Bonnes pratiques

1. Garder la cohérence

2. Utiliser l'imbrication à bon escient

3. Organiser sémantiquement

Sortie HTML

Exemples pratiques

Liste de courses

Plan d'étude

Liste des fonctionnalités d'API

Syntaxes associées

Pratique