Caractères d'échappement
Les caractères d'échappement permettent d'afficher dans Markdown des caractères qui auraient sinon une signification spéciale. En ajoutant un antislash \
devant un caractère, vous annulez sa fonction spéciale.
Principe de base de l'échappement
Qu'est-ce que l'échappement
Dans Markdown, certains caractères ont une signification spéciale (comme *
pour l'emphase). Lorsque vous souhaitez afficher ces caractères eux-mêmes, vous devez utiliser l'échappement.
Ceci est du texte *italique*.
Ceci est du texte \*avec un astérisque simple\*.
Rendu :
Ceci est du texte italique. Ceci est du texte *avec un astérisque simple*.
Caractères nécessitant un échappement
Liste complète
Les caractères suivants ont une signification spéciale en Markdown et doivent être échappés :
Caractère | Description | Syntaxe d'échappement | Usage |
---|---|---|---|
\ | Antislash | \\ | Caractère d'échappement |
` | Backtick | \` | Code en ligne |
* | Astérisque | \* | Emphase, listes |
_ | Souligné | \_ | Emphase |
{} | Accolades | \{ \} | Syntaxe étendue |
[] | Crochets | \[ \] | Liens, images |
() | Parenthèses | \( \) | Liens, images |
# | Dièse | \# | Titres |
+ | Plus | \+ | Listes |
- | Tiret | \- | Listes, règle horizontale |
. | Point | \. | Listes ordonnées |
! | Point d'exclamation | \! | Images |
Exemples courants d'échappement
Astérisques et soulignés
❌ Non échappé :
Ce nom de fichier est file_name_v2.txt
Cette formule est 2*3*4 = 24
✅ Échappé :
Ce nom de fichier est file\_name\_v2.txt
Cette formule est 2\*3\*4 = 24
Rendu :
❌ Non échappé : Ce nom de fichier est file_name_v2.txt Cette formule est 234 = 24
✅ Échappé : Ce nom de fichier est file_name_v2.txt Cette formule est 2*3*4 = 24
Dièses pour les titres
❌ Non échappé :
# À FAIRE : Terminer la tâche
✅ Échappé :
\# À FAIRE : Terminer la tâche
Rendu :
❌ Non échappé :
À FAIRE : Terminer la tâche
✅ Échappé : # À FAIRE : Terminer la tâche
Symboles de liste
❌ Non échappé :
Prix : 100 - 200 EUR
Étapes : 1. Préparer 2. Exécuter
✅ Échappé :
Prix : 100 \- 200 EUR
Étapes : 1\. Préparer 2\. Exécuter
Rendu :
❌ Non échappé : Prix : 100 - 200 EUR Étapes : 1. Préparer 2. Exécuter
✅ Échappé : Prix : 100 - 200 EUR Étapes : 1. Préparer 2. Exécuter
Syntaxe des liens
❌ Non échappé :
Voir la documentation [ici](http://exemple.com)
✅ Échappé (affichage brut) :
Voir la documentation \[ici\]\(http://exemple.com\)
Rendu :
❌ Non échappé : Voir la documentation ici
✅ Échappé (affichage brut) : Voir la documentation [ici](http://exemple.com)
Cas particuliers
Antislash lui-même
Pour afficher un antislash, utilisez deux antislashs :
Chemin de fichier : C:\\Utilisateurs\\Nom\\Documents
Chemin Unix : /home/user/documents
Rendu :
Chemin de fichier : C:\Utilisateurs\Nom\Documents Chemin Unix : /home/user/documents
Échapper les backticks
Pour afficher des backticks dans du code :
Utilisez `` \` `` pour entourer du code
Utilisez ``` \`\`\` ``` pour créer des blocs de code
Rendu :
Utilisez \`
pour entourer du code Utilisez \`\`\`
pour créer des blocs de code
Antislash en fin de ligne
Un antislash en fin de ligne a une signification spéciale (saut de ligne forcé) :
Première ligne\
Deuxième ligne (saut de ligne forcé)
Première ligne\\
Deuxième ligne (affiche l'antislash)
Rendu :
Première ligne
Deuxième ligne (saut de ligne forcé)
Première ligne\ Deuxième ligne (affiche l'antislash)
Échappement dans le code
Code en ligne
Dans le code en ligne, la plupart des caractères n'ont pas besoin d'être échappés :
Code : `let result = 2 * 3 + 1;`
Chemin : `C:\Users\*\Documents`
Rendu :
Code : let result = 2 * 3 + 1;
Chemin : C:\Users\*\Documents
Blocs de code
Dans les blocs de code, les caractères sont préservés tels quels :
```javascript
// Ces symboles n'ont pas besoin d'être échappés
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";
```
Rendu :
// Ces symboles n'ont pas besoin d'être échappés
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";
Scénarios d'application pratiques
1. Documentation technique
## Syntaxe du fichier de configuration
Le fichier de configuration utilise le format suivant :
# Ligne de commentaire key = value [section]
Note :
- Utilisez \# pour commencer un commentaire
- Utilisez \[\] pour définir une section
- Utilisez \* comme joker
2. Expressions mathématiques
## Formules mathématiques
Équation linéaire : y = a\*x + b
Équation du second degré : y = a\*x² + b\*x + c
Fraction : 1/2 = 0.5
Note : Utilisez \* comme opérateur de multiplication
3. Chemins de fichiers
## Système de fichiers
Chemins Windows :
- Dossier système : C:\\Windows\\System32
- Dossier utilisateur : C:\\Users\\{utilisateur}
- Dossier programme : C:\\Program Files\\*
Chemins Linux :
- Dossier racine : /
- Dossier utilisateur : /home/{utilisateur}
- Joker : /var/log/\*.log
4. Explication de symboles spéciaux
## Signification des symboles
En programmation :
- \* signifie généralement pointeur ou joker
- \_ est utilisé pour les conventions de nommage (comme \_private)
- \# est utilisé pour les commentaires ou directives de préprocesseur
- \[\] signifie tableau ou paramètre optionnel
- \{\} signifie bloc de code ou placeholder
Bonnes pratiques pour l'échappement
1. N'échappez que si nécessaire
✅ Recommandé : N'échapper que les caractères ambigus
Nom de fichier : config.txt
Prix : 10-20 €
❌ Non recommandé : Sur-échappement
Nom de fichier : config\.txt
Prix : 10\-20
2. Restez cohérent
✅ Recommandé : Style d'échappement cohérent
Noms de variables : user\_id, item\_count, max\_size
❌ Non recommandé : Gestion incohérente
Noms de variables : user_id, item\_count, max_size
3. Utilisez la mise en forme code
S'il y a beaucoup de caractères spéciaux, utilisez la mise en forme code :
✅ Recommandé : Utilisez la mise en forme code
Syntaxe de config : `[section]` et `key=value`
❌ Non recommandé : Échappement excessif
Syntaxe de config : \[section\] et key\=value
Erreurs courantes
1. Oubli d'échappement
❌ Incorrect :
Mon nom GitHub est user_name
Cette fonction s'appelle get_data()
✅ Correct :
Mon nom GitHub est user\_name
Cette fonction s'appelle get\_data()
2. Sur-échappement
❌ Incorrect :
Aujourd'hui c'est le 12\-25
Ce fichier est README\.md
✅ Correct :
Aujourd'hui c'est le 12-25
Ce fichier est README.md
3. Erreur de contexte
❌ Incorrect : Échappement dans un bloc de code
let path = "C:\Users\Name"; ← Pas besoin de double échappement
✅ Correct :
let path = "C:\Users\Name";
Sortie HTML
Sortie HTML pour les caractères d'échappement :
Ceci est du texte \*avec un astérisque\*
Converti en :
<p>Ceci est du texte *avec un astérisque*</p>
Éditeurs et outils
Éditeurs prenant en charge l'aperçu de l'échappement
- Visual Studio Code : Markdown Preview Enhanced
- Typora : Aperçu en temps réel
- Mark Text : WYSIWYG
- Obsidian : Rendu en direct
Outils de vérification d'échappement
<!-- Règles markdownlint -->
MD049 : Cohérence des marqueurs d'emphase
MD050 : Style des marqueurs d'emphase
Syntaxes associées
- Syntaxe de l'emphase – Utilisation des astérisques et soulignés
- Syntaxe du code – Caractères spéciaux dans le code
- Syntaxe des liens – Crochets et parenthèses
- Syntaxe des listes – Marqueurs de liste
Pratique
Essayez d'afficher correctement les éléments suivants :
- Chemin de fichier :
C:\Program Files\*\config.ini
- Noms de variables :
user_id
,file_name
,max_count
- Expression mathématique :
2*x + 3*y = 15
- Syntaxe de config :
[section]
etkey=value
- Syntaxe Markdown :
**gras**
et*italique*
Tableau de référence
Récapitulatif des échappements courants
Original | Échappé | Description |
---|---|---|
\ | \\ | Antislash |
* | \* | Astérisque |
_ | \_ | Souligné |
# | \# | Dièse |
[ | \[ | Crochet gauche |
] | \] | Crochet droit |
( | \( | Parenthèse gauche |
) | \) | Parenthèse droite |
+ | \+ | Plus |
- | \- | Tiret |
. | \. | Point |
! | \! | Point d'exclamation |