Syntaxe Étendue Markdown
La syntaxe Markdown de base fournit les éléments essentiels pour créer des documents, mais cela ne suffit pas toujours pour des besoins spécifiques. C'est là qu'intervient la syntaxe étendue.
La syntaxe étendue ajoute des fonctionnalités supplémentaires aux bases, permettant de créer des documents plus riches et plus complexes.
Qu'est-ce que la syntaxe étendue ?
La syntaxe étendue désigne les éléments de syntaxe au-delà de la spécification originale de Markdown. Ces extensions sont ajoutées par différents processeurs Markdown pour supporter des fonctionnalités additionnelles.
Syntaxes étendues courantes
- Tableaux – Créer des tableaux de données
- Blocs de code délimités – Blocs de code avec coloration syntaxique
- Notes de bas de page – Ajouter des références
- IDs de titres – Ajouter des IDs personnalisés aux titres
- Listes de définitions – Listes de termes et définitions
- Barré – Barrer du texte
- Listes de tâches – Listes à cocher interactives
- Émojis – Symboles emoji
- Surlignage – Mettre en évidence du texte
- Indice et exposant – Utilisé dans les formules mathématiques
Prise en charge
Notez que toutes les applications Markdown ne prennent pas en charge la syntaxe étendue. Avant d'utiliser une extension, vérifiez si votre processeur Markdown la supporte.
Prise en charge des principaux outils
Les plateformes et outils suivants prennent bien en charge la syntaxe étendue :
- GitHub Flavored Markdown (GFM) – Extension Markdown de GitHub
- GitLab Flavored Markdown – Extension de GitLab
- Typora – Éditeur Markdown riche
- Obsidian – Outil de gestion de connaissances
- VitePress – Générateur de site statique
- Hugo – Générateur de site statique
Tableaux
Créer des tableaux est l'une des extensions les plus courantes :
| Nom | Âge | Profession |
|------|-----|-----------|
| Zhang | 25 | Ingénieur |
| Li | 30 | Designer || Nom | Âge | Profession |
|---|---|---|
| Zhang | 25 | Ingénieur |
| Li | 30 | Designer |
Blocs de code délimités
Blocs de code avec coloration syntaxique :
```javascript
function hello() {
console.log("Hello, World!");
}
```function hello() {
console.log("Hello, World!");
}Listes de tâches
Créer des listes de choses à faire :
- [x] Finaliser le plan du projet
- [ ] Écrire le code
- [ ] Tester les fonctionnalités
- [ ] Déployer en ligne- [x] Finaliser le plan du projet
- [ ] Écrire le code
- [ ] Tester les fonctionnalités
- [ ] Déployer en ligne
Barré
Indiquer du contenu supprimé ou incorrect :
~~Ce texte est barré~~Ce texte est barré
Liens automatiques
Reconnaissance automatique des URLs et adresses email :
Visitez https://markdown.com.cn pour plus d'informations.
Contact : example@domain.comVisitez https://markdown.com.cn pour plus d'informations. Contact : example@domain.com
Notes de bas de page
Ajouter des notes et références à votre document :
Voici un exemple de note de bas de page[^1].
[^1]: Ceci est le contenu de la note.Voici un exemple de note de bas de page[^1].
[^1]: Ceci est le contenu de la note.
Listes de définitions
Créer des listes de termes et définitions :
Markdown
: Un langage de balisage léger
HTML
: HyperText Markup Language
: Le langage standard pour créer des pages webFormules mathématiques
Prise en charge des formules LaTeX :
Formule en ligne : $E = mc^2$
Formule bloc :
$$
\sum_{i=1}^n a_i = 0
$$Graphiques et diagrammes
Certains éditeurs avancés supportent les diagrammes Mermaid :
```mermaid
graph TD
A[Début] --> B{Compris ?}
B -->|Oui| C[Continuer à apprendre]
B -->|Non| D[Relire]
D --> B
C --> E[Fin]
```Parcours d'apprentissage de la syntaxe étendue
Il est recommandé d'apprendre la syntaxe étendue dans l'ordre suivant :
- Tableaux – Le plus courant et pratique
- Blocs de code délimités – Indispensable pour les développeurs
- Listes de tâches – Idéal pour la gestion de projet
- Barré – Simple et facile à utiliser
- Notes de bas de page – Nécessaire pour la rédaction académique
- Listes de définitions – Pour les explications de termes
- IDs de titres – Pour des liens avancés
- Surlignage – Mettre en avant les points clés
Conseils de compatibilité
Lorsque vous utilisez la syntaxe étendue :
- Testez la compatibilité – Testez votre Markdown sur la plateforme cible
- Prévoyez des alternatives – Pensez à l'affichage sur les plateformes qui ne supportent pas les extensions
- Documentez l'utilisation – Indiquez quelles extensions sont utilisées dans vos docs
- Standardisez vos choix – Utilisez un ensemble d'extensions unifié dans votre équipe
Pour aller plus loin
Choisissez la syntaxe étendue qui vous intéresse pour commencer :