Syntaxe des citations

Les citations (blockquotes) servent à mettre en avant un texte cité ou à souligner une information importante. En Markdown, utilisez le symbole > pour créer un bloc de citation.

Syntaxe de base des citations

Citation sur une seule ligne

Utilisez le symbole > au début d'une ligne pour créer une citation :

markdown

> Ceci est une citation.

Rendu :

Ceci est une citation.

Citation sur plusieurs lignes

markdown

> Ceci est la première ligne de la citation.
> Ceci est la deuxième ligne de la citation.
> Ceci est la troisième ligne de la citation.

Rendu :

Ceci est la première ligne de la citation. Ceci est la deuxième ligne de la citation. Ceci est la troisième ligne de la citation.

Paragraphes dans une citation

Incluez plusieurs paragraphes dans une citation :

markdown

> Ceci est le premier paragraphe de la citation.
>
> Ceci est le second paragraphe de la citation.

Rendu :

Ceci est le premier paragraphe de la citation.
Ceci est le second paragraphe de la citation.

Citations imbriquées

Imbrication de base

Utilisez >> pour créer des citations imbriquées :

markdown

> Ceci est la citation de premier niveau.
>
> > Ceci est la citation de second niveau.
>
> Retour au premier niveau de citation.

Rendu :

Ceci est la citation de premier niveau.
Ceci est la citation de second niveau.
Retour au premier niveau de citation.

Imbrication multi-niveaux

markdown

> Citation niveau 1
> > Citation niveau 2
> > > Citation niveau 3
> > > > Citation niveau 4
> >
> > Retour au niveau 2
>
> Retour au niveau 1

Rendu :

Citation niveau 1
Citation niveau 2
Citation niveau 3
Citation niveau 4
Retour au niveau 2
Retour au niveau 1

Autres éléments dans les citations

Mise en forme dans les citations

markdown

> Le **texte en gras** et le *texte en italique* fonctionnent normalement dans les citations.
> 
> Vous pouvez utiliser du `code en ligne` et d'autres mises en forme.

Rendu :

Le texte en gras et le texte en italique fonctionnent normalement dans les citations.
Vous pouvez utiliser du code en ligne et d'autres mises en forme.

Titres dans les citations

markdown

> ## Titre dans une citation
> 
> Ceci est le contenu principal de la citation.
> 
> ### Sous-titre
> 
> Plus de contenu cité.

Rendu :

Titre dans une citation
Ceci est le contenu principal de la citation.
Sous-titre
Plus de contenu cité.

Listes dans les citations

markdown

> Liste dans une citation :
> 
> 1. Premier élément
> 2. Deuxième élément
> 3. Troisième élément
> 
> Ou liste non ordonnée :
> 
> - Élément A
> - Élément B
> - Élément C

Rendu :

Liste dans une citation :
Premier élément
Deuxième élément
Troisième élément
Ou liste non ordonnée :
Élément A
Élément B
Élément C

Blocs de code dans les citations

markdown

> Voici un exemple de code :
> 
> ```javascript
> function hello() {
>   console.log("Bonjour, Monde !");
> }
> ```
> 
> Les blocs de code s'affichent aussi correctement dans les citations.

Rendu :

Voici un exemple de code :
javascript
function hello() {
  console.log("Bonjour, Monde !");
}
Les blocs de code s'affichent aussi correctement dans les citations.

Liens dans les citations

markdown

> Voir la [documentation officielle](https://www.markdownlang.com) pour plus d'informations.
> 
> Vous pouvez aussi visiter <https://www.markdownlang.com> pour un lien direct.

Rendu :

Voir la documentation officielle pour plus d'informations.
Vous pouvez aussi visiter https://www.markdownlang.com pour un lien direct.

Scénarios d'utilisation courants

1. Citation littéraire

markdown

> « Markdown est un langage de balisage léger qui permet de rédiger des documents dans un format texte facile à lire et à écrire. »
> 
> —— John Gruber, créateur de Markdown

Rendu :

« Markdown est un langage de balisage léger qui permet de rédiger des documents dans un format texte facile à lire et à écrire. »
—— John Gruber, créateur de Markdown

2. Message d'avertissement

markdown

> ⚠️ **Avertissement**
> 
> Cette action supprimera toutes les données. Veuillez sauvegarder les fichiers importants.

Rendu :

⚠️ Avertissement
Cette action supprimera toutes les données. Veuillez sauvegarder les fichiers importants.

3. Message d'astuce

markdown

> 💡 **Astuce**
> 
> Utilisez le raccourci `Ctrl+S` pour enregistrer rapidement le document.

Rendu :

💡 Astuce
Utilisez le raccourci Ctrl+S pour enregistrer rapidement le document.

4. Note importante

markdown

> 📌 **Note importante**
> 
> Avant de commencer, assurez-vous d'avoir installé les dépendances suivantes :
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

Rendu :

📌 Note importante
Avant de commencer, assurez-vous d'avoir installé les dépendances suivantes :
Node.js (>= 14.0)
npm (>= 6.0)
Git

Erreurs courantes et solutions

1. Oubli du symbole >

markdown

❌ Incorrect :
> Première ligne de la citation
Deuxième ligne sans symbole >  ← Cette ligne ne sera pas incluse dans la citation

✅ Correct :
> Première ligne de la citation
> Deuxième ligne correctement citée

2. Erreur de niveau d'imbrication

markdown

❌ Incorrect :
> Niveau 1
> > > Passage direct au niveau 3  ← Niveau 2 sauté

✅ Correct :
> Niveau 1
> > Niveau 2
> > > Niveau 3

3. Gestion des lignes vides

markdown

❌ Problème potentiel :
> Premier paragraphe

> Second paragraphe  ← Cela crée deux citations séparées

✅ Citation multi-paragraphes correcte :
> Premier paragraphe
>
> Second paragraphe

Bonnes pratiques

1. Garder un style cohérent

markdown

✅ Recommandé : Style de citation unifié
> Toutes les informations importantes utilisent des citations
> Gardez la mise en forme cohérente

❌ Non recommandé : Usage mixte
> Parfois une citation
**Parfois du gras à la place**

2. Utiliser l'imbrication à bon escient

markdown

✅ Recommandé : Imbrication simple et claire
> Point principal
> > Argument de soutien
> 
> Suite du point principal

❌ Non recommandé : Imbrication trop profonde
> > > > > Trop profond, difficile à lire

3. Utiliser de façon sémantique

markdown

✅ Recommandé : Citations porteuses de sens
> Ceci est une information importante issue d'un document de référence

❌ Non recommandé : Citations décoratives
> Ceci est juste un texte normal, pas besoin de citation

Sortie HTML

Les citations Markdown sont converties en HTML :

markdown

> Ceci est un texte cité

Devient :

html

<blockquote>
  <p>Ceci est un texte cité</p>
</blockquote>

Citations imbriquées :

markdown

> Niveau 1
> > Niveau 2

Devient :

html

<blockquote>
  <p>Niveau 1</p>
  <blockquote>
    <p>Niveau 2</p>
  </blockquote>
</blockquote>

Styles personnalisés

Certains moteurs Markdown prennent en charge des styles de citation personnalisés :

Admonitions à la GitHub

markdown

> [!NOTE]
> Ceci est une note d'information

> [!WARNING]
> Ceci est une note d'avertissement

> [!IMPORTANT]
> Ceci est une note importante

Utilisation de HTML et CSS

markdown

<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
Ceci est une citation personnalisée
</blockquote>

Exemples pratiques

Exemple dans une documentation d'API

markdown

## Authentification utilisateur

L'authentification utilisateur est une étape nécessaire pour accéder à l'API.

> **Méthode d'authentification**
> 
> Notre API utilise le Bearer Token pour l'authentification :
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### Exemple de requête

Envoyez une requête POST pour créer un utilisateur :

> ```json
> {
>   "name": "John Doe",
>   "email": "john@example.com",
>   "role": "user"
> }
> ```

Notes dans les tutoriels

markdown

## Étapes d'installation

1. Téléchargez l'installeur
2. Lancez l'installeur

> ⚠️ **Note**
> 
> Avant l'installation, assurez-vous :
> - Que l'antivirus est désactivé
> - De lancer en tant qu'administrateur
> - Que le disque système dispose d'au moins 2 Go d'espace libre

3. Terminez l'assistant d'installation

Syntaxes associées

Syntaxe de l'emphase – Mise en forme du texte
Syntaxe des listes – Listes à puces
Syntaxe du code – Mise en forme du code
Syntaxe des liens – Création de liens

Pratique

Essayez de créer les éléments suivants :

Une citation avec plusieurs paragraphes
Une structure de citation imbriquée sur trois niveaux
Une citation technique avec un exemple de code
Une citation imbriquée simulant une conversation

Syntaxe des citations ​

Syntaxe de base des citations ​

Citation sur une seule ligne ​

Citation sur plusieurs lignes ​

Paragraphes dans une citation ​

Citations imbriquées ​

Imbrication de base ​

Imbrication multi-niveaux ​

Autres éléments dans les citations ​

Mise en forme dans les citations ​

Titres dans les citations ​

Titre dans une citation ​

Sous-titre ​

Listes dans les citations ​

Blocs de code dans les citations ​

Liens dans les citations ​

Scénarios d'utilisation courants ​

1. Citation littéraire ​

2. Message d'avertissement ​

3. Message d'astuce ​

4. Note importante ​

Erreurs courantes et solutions ​

1. Oubli du symbole > ​

2. Erreur de niveau d'imbrication ​

3. Gestion des lignes vides ​

Bonnes pratiques ​

1. Garder un style cohérent ​

2. Utiliser l'imbrication à bon escient ​

3. Utiliser de façon sémantique ​

Sortie HTML ​

Styles personnalisés ​

Admonitions à la GitHub ​

Utilisation de HTML et CSS ​

Exemples pratiques ​

Exemple dans une documentation d'API ​

Notes dans les tutoriels ​

Syntaxes associées ​

Pratique ​

Syntaxe des citations

Syntaxe de base des citations

Citation sur une seule ligne

Citation sur plusieurs lignes

Paragraphes dans une citation

Citations imbriquées

Imbrication de base

Imbrication multi-niveaux

Autres éléments dans les citations

Mise en forme dans les citations

Titres dans les citations

Titre dans une citation

Sous-titre

Listes dans les citations

Blocs de code dans les citations

Liens dans les citations

Scénarios d'utilisation courants

1. Citation littéraire

2. Message d'avertissement

3. Message d'astuce

4. Note importante

Erreurs courantes et solutions

1. Oubli du symbole >

2. Erreur de niveau d'imbrication

3. Gestion des lignes vides

Bonnes pratiques

1. Garder un style cohérent

2. Utiliser l'imbrication à bon escient

3. Utiliser de façon sémantique

Sortie HTML

Styles personnalisés

Admonitions à la GitHub

Utilisation de HTML et CSS

Exemples pratiques

Exemple dans une documentation d'API

Notes dans les tutoriels

Syntaxes associées

Pratique