2024-04-15
Créer des tables en Markdown est un processus simple qui améliore l'organisation et la présentation des données sur le web. Ce guide couvre tout ce que vous devez savoir, de la syntaxe de base aux options de formatage avancées :
Markdown Toolbox
| et des tirets - pour créer des tables simples.:.& et | en utilisant des entités HTML ou des backslashes.À la fin de ce guide, vous serez prêt à créer des tables claires et informatives en Markdown, rendant votre contenu plus structuré et accessible.
Vous pouvez décider comment aligner votre texte dans les colonnes en ajustant la ligne des tirets - :
:---: = Le texte est aligné à gauche:--: = Le texte est centré---: = Le texte est aligné à droite| Gauche | Centre | Droite |
| :--- | :----: | ----: |
| Texte | Texte | Texte |
Par exemple :
| Gauche | Centre | Droite |
|---|---|---|
| Texte | Texte | Texte |
Vous pouvez rendre le texte en gras, en italique, ajouter des liens, ou même du code à l'intérieur des cellules des tables en utilisant des astuces Markdown habituelles :
** ou __* ou _Blocs de code en lignePar exemple :
| Nom | Description |
|---|---|
| John | Enseignant qui aime apprendre de nouvelles choses |
| Sarah | Ingénieur travaillant sur de superbes projets |
Cela montre les bases de la création de tables en Markdown. Avec un peu de pratique, elles peuvent être un excellent moyen d'organiser les données de manière claire pour les pages web ou les documents.
Lorsque vous créez des tables en Markdown, parfois vous voudrez inclure des caractères spéciaux que le format Markdown utilise habituellement pour d'autres choses. Par exemple, comme Markdown utilise des pipes | pour séparer les colonnes, si vous voulez montrer un symbole de pipe à l'intérieur d'une cellule, vous devez contourner cela.
Il existe plusieurs façons de le faire :
Une façon est d'utiliser des entités de caractères HTML. Ce sont des codes spéciaux qui vous permettent d'afficher des caractères ayant d'autres significations en HTML ou Markdown. Par exemple, & pour un esperluette &, et | pour un pipe |.
Voici à quoi cela ressemble :
| Caractère | Entité | Rendu Exemple |
|---|---|---|
| Esperluette | & |
R&D |
| Pipe | | |
Colonne|En-tête |
Vous pouvez trouver une liste complète des entités de caractères HTML ici.
Une autre façon est de mettre un backslash \ avant le caractère spécial. Cela indique à Markdown de traiter le caractère suivant comme n'importe quel autre texte.
\| = montre un pipe |
\\ = montre un backslash \
Mais souvenez-vous, l'utilisation d'un backslash ne fonctionne pas pour chaque caractère dans les tables Markdown, comme le pipe |.
Enfin, vous pouvez utiliser des blocs de code Markdown pour afficher les caractères spéciaux exactement tels qu'ils sont. Il suffit de les mettre entre des backticks `.
` | * | & | \ | | `` ``
Cela ressemblera à :
| * | & | \ | ` |
|---|---|---|---|
| * | & | \ | ` |
En résumé, utilisez des entités HTML ou des backslashes lorsque vous le pouvez pour échapper aux caractères spéciaux. Pour les pipes et autres symboles délicats, les blocs de code sont un bon moyen de les montrer tels quels.
Markdown existe sous différentes formes, chacune ayant sa propre manière de gérer les tables. Examinons ces styles et quelques conseils pour créer d'excellentes tables :
GFM est ce que vous voyez sur GitHub. Il vous permet de créer des tables facilement :
| En-tête 1 | En-tête 2 |
|----------|----------|
| Ligne 1a | Ligne 1b |
| Ligne 2a | Ligne 2b |
Vous n'avez pas besoin de mettre des pipes | à la fin de chaque ligne, mais c'est une bonne idée pour éviter les erreurs.
Ces versions ajoutent plus d'options pour les tables, comme l'alignement du texte :
| Droite | Gauche | Par défaut | Centre |
|------:|:-----|---------|:-----:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
Utilisez un deux-point : pour contrôler l'alignement du texte.
CommonMark n'a pas sa propre syntaxe de table. Vous devez utiliser des balises HTML pour créer des tables.
Dans GFM et des styles similaires, vous n'avez pas toujours besoin des pipes latéraux | :
En-tête 1 | En-tête 2
--------- | ---------
Ligne 1a | Ligne 1b
Ligne 2a | Ligne 2b
Les omettre peut faciliter l'édition, mais les avoir aide à éviter les erreurs.
Essayez d'aligner les largeurs des colonnes pour que votre table soit plus nette :
| Court | Colonne d'exemple plus longue |
|-------|-----------------------|
| Texte | Plus de texte exemple |
Cela rend votre table plus facile à lire.
Créer des tables de toutes pièces peut être difficile. Voici quelques outils pour aider :
Le Générateur de tableaux Markdown vous permet de créer des tables sans coder. Il suffit de remplir vos informations et il vous donne le code.
Table Convert transforme rapidement les données des tableurs en tables Markdown.
Le éditeur Markdown Typora a une manière simple d'ajouter et de styliser des tables.
Certaines applications facilitent le travail avec des tables Markdown :
Typora a un menu simple pour ajouter et modifier des tables.
Zettlr vous permet d'insérer une table de base puis de l'éditer directement.
Connaître ces astuces et outils peut rendre le travail avec des tables Markdown beaucoup plus fluide. N'oubliez pas, l'objectif est de rendre l'information claire et facile à lire.
Faisons un peu de pratique en créant des tables avec Markdown. Voici quelques exercices faciles pour vous aider à vous familiariser :
Tout d'abord, créons une table simple qui liste différents fruits :
| Fruit | Couleur | Forme |
| Fruit | Couleur | Forme |
| - | - | - |
| Fruit | Couleur | Forme |
| - | - | - |
| Pomme | Rouge | Ronde |
| Fruit | Couleur | Forme |
| - | - | - |
| Pomme | Rouge | Ronde |
| Banane | Jaune | Longue |
| Orange | Orange | Ronde |
Ensuite, ajoutons un peu de style à notre table de fruits :
** autour d'eux :| **Fruit** | **Couleur** | **Forme** |
| - | - | - |
| Banane | *Jaune* | Long |
| Orange | [Orange](https://www.w3schools.com/colors/colors_names.asp) | Ronde |
Pour un peu plus de défi, créons une table avec plus de détails :
| **Nom** | **Poste** | **Salaire** |
| - | - | - |
| **Nom** | **Poste** | **Salaire** |
| - | - | - |
| John | Manager | $80,000 |
| Sarah | Developer | $60,000 |
| Lisa | Designer | $50,000 |
| **Nom** | **Poste** | **Salaire** |
| - | - | ---: |
Pratiquer avec ces étapes est un excellent moyen de se familiariser avec la création de tables Markdown. Essayez de créer différents types de tables et jouez avec le formatage pour voir ce que vous pouvez faire.
Éditer des tables en Markdown peut être un peu fastidieux, mais connaître quelques raccourcis clavier peut rendre cela beaucoup plus facile. Voici une liste de raccourcis qui peuvent vous aider à travailler plus rapidement :
Tab - Passer à la cellule suivanteShift + Tab - Revenir à la cellule précédenteEnter - Descendre à la ligne suivanteCtrl/Cmd + Enter - Arrêter d'éditer la tableCtrl/Cmd + Touche de Flèche - Se déplacer facilement dans les cellulesCtrl/Cmd + l - Aligner le texte à gaucheCtrl/Cmd + e - Centrer le texteCtrl/Cmd + r - Aligner le texte à droiteCtrl/Cmd + . - Supprimer tout alignement spécifiqueAlt + i - Ajouter une nouvelle ligne au-dessusAlt + a - Ajouter une nouvelle ligne en dessousAlt + j - Ajouter une colonne à gaucheAlt + l - Ajouter une colonne à droiteAlt + Shift + i - Supprimer la ligne actuelleAlt + Shift + a - Supprimer la ligne actuelleAlt + Shift + j - Supprimer la colonne actuelleAlt + Shift + l - Supprimer la colonne actuelleShift + Touche de Flèche - Sélectionner plus de cellulesCtrl/Cmd + Alt + Touche de Flèche - Déplacer toute la ligne ou colonneEn vous familiarisant avec ces raccourcis, vous pouvez accélérer votre travail avec les tables en Markdown. Gardez ce guide à portée de main pour une référence rapide.
Faire des tables avec Markdown vous permet d'organiser des informations de manière soignée pour les sites web. C'est assez simple une fois que vous vous y habituez. Voici ce qu'il faut garder à l'esprit :
|. Mettez des tirets - sous la ligne d'en-tête pour montrer comment le texte doit s'aligner.: à côté des tirets sous la colonne que vous souhaitez ajuster.Continuez simplement à pratiquer, et bientôt, créer des tables Markdown semblera facile. N'oubliez pas de garder vos tables simples et claires. L'objectif principal est de partager des informations d'une manière facile à comprendre pour tout le monde. Les tables Markdown sont excellentes pour cela car elles vous permettent d'organiser des données de manière ordonnée et simple.
Pour créer des tables en Markdown, utilisez le symbole pipe | pour créer des colonnes, des tirets - pour aligner le texte sous les en-têtes, et des deux-points : pour aligner le texte à gauche, au centre ou à droite. Commencez avec les en-têtes dans la première ligne, des tirets dans la seconde pour définir les colonnes, puis ajoutez vos informations ci-dessous. Gardez tout au propre pour une lecture plus facile. Certains éditeurs Markdown peuvent vous aider à formater la table plus facilement.
Pour aligner le texte dans une table :
:---:---:---:Il vous suffit de changer les tirets sous la colonne que vous souhaitez aligner dans la seconde ligne.
Beaucoup d'éditeurs Markdown, comme Typora ou Zettlr, ont des raccourcis pour insérer rapidement une structure de table vide. Par exemple, dans Typora sur Windows, appuyer sur Ctrl + T mettra une table vide dans votre document. Consultez le guide de votre éditeur pour des raccourcis spécifiques.
Pour indenter un bloc de code, ajoutez une ligne vide avant et après votre code, et indentez chaque ligne du code avec au moins 4 espaces ou 1 tabulation. Cela indique à Markdown de le formater d'une manière spéciale, généralement avec une police différente pour le faire ressortir en tant que code.