Ce guide complet couvre toutes les fonctionnalités de Markdown que vous devez connaître en tant que développeur. Des formatages de base aux tableaux et blocs de code avancés.
Formatage du texte
Markdown prend en charge diverses options de formatage du texte :
- Texte en gras pour l'emphase
- Texte en italique pour une emphase subtile
Texte barrépour le contenu supprimé- Gras et italique combinés
code en lignepour les extraits de code- Texte surligné pour le contenu important
- Texte inséré pour les ajouts
- Petit texte pour les mentions légales
En-têtes
Vous pouvez créer des en-têtes de H1 à H6 à l'aide du symbole #. Chaque niveau offre une hiérarchie différente pour la structure de votre contenu.
Ceci est un en-tête H3
Ceci est un en-tête H4
Ceci est un en-tête H5
Ceci est un en-tête H6
Listes
Listes non ordonnées
- Premier élément
- Deuxième élément
- Élément imbriqué 1
- Élément imbriqué 2
- Troisième élément
Listes ordonnées
- Première étape
- Deuxième étape
- Troisième étape
- Sous-étape A
- Sous-étape B
Listes de tâches
- Tâche terminée
- Autre tâche terminée
- Tâche en attente
- Tâche future
Listes de définitions
- HTML
- HyperText Markup Language - le langage de balisage standard pour les pages Web
- CSS
- Cascading Style Sheets - utilisé pour le style des éléments HTML
- JavaScript
- Un langage de programmation qui permet des pages Web interactives
Blocs de code
Le code en ligne comme const x = 10 est idéal pour les courts extraits.
Pour les codes plus longs, utilisez les blocs de code avec délimitation :
function greet(name) {
console.log(`Bonjour, ${name} !`);
return {
message: 'Bienvenue',
timestamp: Date.now()
};
}
def calculate_sum(numbers):
return sum(numbers)
result = calculate_sum([1, 2, 3, 4, 5])
print(f\"Somme : {result}\")
npm install react
npm run dev
Tableaux
Les tableaux sont idéaux pour comparer les données :
| Fonctionnalité | React | Vue | Angular |
|---|---|---|---|
| Courbe d'apprentissage | Moyenne | Facile | Difficile |
| Performances | Élevées | Élevées | Moyennes |
| Communauté | Importante | En croissance | Importante |
| TypeScript | Facultatif | Facultatif | Intégré |
Blocs de citation
Ceci est un bloc de citation. Il est parfait pour mettre en évidence des informations importantes ou citer des sources.
Vous pouvez avoir plusieurs paragraphes dans un bloc de citation.
Liens et images
Visitez ZetaBox pour plus d'informations sur nos services.
Règles horizontales
Utilisez des règles horizontales pour séparer les sections :
Raccourcis clavier
Raccourcis clavier courants :
- Appuyez sur Ctrl + C pour copier
- Appuyez sur Ctrl + V pour coller
- Appuyez sur Ctrl + S pour enregistrer
- Appuyez sur Alt + Tab pour changer de fenêtre
Sections réductibles
Cliquez pour développer - Configuration avancée
Ce contenu est masqué par défaut. Vous pouvez y placer des informations détaillées que les utilisateurs peuvent développer au besoin.
- Option de configuration 1
- Option de configuration 2
- Option de configuration 3
Cliquez pour développer - Guide de dépannage
Problèmes courants et leurs solutions :
-
Problème : Module introuvable Solution : Exécutez
npm install -
Problème : Le port est déjà utilisé Solution : Arrêtez le processus ou utilisez un port différent
Éléments techniques
Variables et exemple de sortie
La variable x représente la valeur d'entrée, et la fonction renvoie Succès : Opération terminée.
Abréviations
Le <abbr title="World Wide Web Consortium">W3C maintient les normes web. Nous utilisons des appels <abbr title="Application Programming Interface">API pour récupérer les données.
Citations et citations
Comme indiqué dans Le programmeur pragmatique : Ne vous répétez pas
est un principe fondamental.
Notation scientifique
- Équation d'Einstein : E = mc2
- Molécule d'eau : H2O
- Dioxyde de carbone : CO2
- Exponentiel : 106 = 1 000 000
Coordonnées
ZetaBox Software EngineeringSfax, Tunisie
Email : contact@zeta-box.com
Conclusion
Markdown est un moyen puissant mais simple de mettre en forme le texte. Il est largement utilisé dans :
- La documentation
- Les fichiers README
- Les articles de blog
- L'écriture technique
- Les applications de discussion
Maîtriser Markdown vous rendra plus productif en tant que développeur !
