Excel est excellent pour le calcul et la saisie de données, mais un classeur est difficile à consulter dans un README, un site de documentation, un problème ou une base de connaissances basée sur Markdown.Les tableaux Markdown résolvent le problème de publication : ils sont en texte brut, faciles à versionner et rendus par GitHub et de nombreux outils de documentation.
Le moyen le plus rapide de convertir Excel en Markdown est d'ouvrir le classeur dans le Outil Excel à Markdown, sélectionnez la feuille de calcul, examinez le tableau et copiez ou téléchargez le Markdown généré.Le classeur est lu localement dans votre navigateur plutôt que téléchargé sur un serveur de conversion.
Ce guide explique ce flux de travail, le compare aux méthodes CSV et copier-coller, et couvre les détails qui provoquent généralement des tableaux cassés.
Comparaison rapide des méthodes
| Méthode | Meilleur pour | Principal avantage | Principale limitation |
|---|---|---|---|
| Outil Excel à Markdown | .xlsx or .xls workbooks | Sélectionnez une feuille de calcul et convertissez-la localement | Exporte les valeurs des cellules, pas le comportement du classeur |
| Outil CSV à Markdown | Dossiers CSV ou TSV | Échange de données simple et portable | Une table plate par dossier |
| Copier et coller | Petites plages visibles | Aucune préparation de dossier | Il est facile de perdre des lignes, des onglets ou des caractères spéciaux |
| Manuel Markdown | Petites tables | Contrôle complet | Lent et sujet aux erreurs pour les ensembles de données plus volumineux |
| Script ou CLI | Conversion automatisée répétée | Reproductible à l'échelle | Nécessite une configuration et une maintenance |
Pour une feuille de calcul occasionnelle, l'outil de navigation est généralement l'option la plus directe.Pour un pipeline de documentation récurrent, un script peut être plus approprié.
Convertir un classeur Excel étape par étape
1. Préparer la feuille de travail
Markdown fonctionnent mieux lorsque la source est une simple plage rectangulaire :
- placer les noms de colonnes dans la première ligne ;
- utilise un enregistrement par ligne ;
- éviter les cellules fusionnées ;
- supprime les lignes de titre décoratives au-dessus du véritable en-tête ;
- conserver les notes en dehors du tableau ;
- rend chaque colonne compréhensible sans formatage uniquement Excel.
Vous n'avez pas besoin de supprimer chaque formule ou style.Le point important est que les valeurs visibles forment un tableau utile lorsqu’elles sont séparées du classeur.
2. Ouvrir le classeur
Ouvert . Excel vers Markdown et choisissez un .xlsx or .xls de votre appareil.Le navigateur lit le classeur localement et répertorie les feuilles de calcul disponibles.
Ceci est utile pour les rapports internes et les projets de documentation car la conversion ne nécessite pas l'envoi de la feuille de calcul à un service de traitement de fichiers distinct.Comme pour tout élément sensible, inspectez la page et les outils réseau de votre navigateur si votre organisation nécessite une vérification indépendante.
3. Sélectionnez la bonne feuille de calcul
Un classeur peut contenir des données brutes, des résumés, des graphiques, des tables de recherche et des onglets archivés.Sélectionnez la feuille de calcul qui contient la table publiable.L'aperçu affiche les premières lignes afin que vous puissiez confirmer que :
- l'entête attendu est présent ;
- le bon onglet a été sélectionné ;
- les données commencent dans la ligne prévue ;
- les lignes d'espacement vides ne sont pas devenues des enregistrements.
Le Markdown généré inclut la feuille de calcul extraite complète même si un aperçu visuel ne peut montrer qu'un nombre limité de lignes pour des raisons de lisibilité.
4. Revoir les Markdown générés
Supposons que la feuille de calcul contienne :
| Produit | Statut officiel | Propriétaire | Mis à jour |
|---|---|---|---|
| Importer API | Je suis prêt. | Les Mayas | 2026-11-18 |
| Guide de facturation | Résumé | Luca | 2026-11-20 |
La sortie Markdown est :
| Product | Status | Owner | Updated |
| --- | --- | --- | --- |
| Import API | Ready | Maya | 2026-11-18 |
| Billing guide | Review | Luca | 2026-11-20 |
Copiez le résultat dans un fichier Markdown, ou téléchargez-le et ouvrez-le dans votre éditeur.Prévisualisez-le dans la destination réelle avant de le publier.
5. Formater la source si nécessaire
Les tableaux générés automatiquement sont valides mais peuvent ne pas être agréables à modifier.Utilisez le Formateur de tableaux Markdown pour aligner les colonnes source et normaliser la ligne de séparation sans modifier les données.
La source alignée est plus facile à examiner dans une pull request :
| Product | Status | Owner | Updated |
| ------------- | ------ | ----- | ---------- |
| Import API | Ready | Maya | 2026-11-18 |
| Billing guide | Review | Luca | 2026-11-20 |
Le rendu est globalement le même ;l'avantage est un texte source plus propre.
Qu'arrive-t-il aux formules ?
Une table Markdown ne peut pas conserver le moteur de formule de Excel.Une formule telle que :
=SUM(B2:B12)
peut avoir un résultat affiché tel que 248.Pour la documentation, la valeur affichée correspond généralement à ce dont les lecteurs ont besoin.La logique de formule, les références de cellules, les plages nommées, les règles de recalcul et les dépendances ne font pas partie de la table Markdown.
Traitez la conversion comme un instantané de publication, pas un classeur de remplacement.Conservez le fichier Excel comme source de vérité lorsque les valeurs doivent continuer à être recalculées.
Avant de publier une feuille riche en formules :
- Ouvrez-le dans Excel ou un autre tableur compatible.
- Recalculez et enregistrez le classeur.
- Confirmez que les valeurs visibles sont actuelles.
- Convertissez la feuille de calcul prévue.
- Ajoutez une note expliquant la date de l'instantané lorsque les données changent fréquemment.
Qu'arrive-t-il au formatage Excel ?
Markdown prend en charge la structure, pas la présentation sous forme de feuille de calcul.Attendez-vous aux compromis suivants :
| Fonctionnalité Excel | Markdown résultat |
|---|---|
| Couleurs de police, de remplissage et de bordure | Non conservé |
| Largeur de colonne et hauteur de ligne | Non conservé |
| Mise en forme conditionnelle | La valeur visible demeure ;la règle n'est pas préservée |
| Formules | La valeur affichée peut être exportée ;la logique de la formule n'est pas conservée |
| Cellules fusionnées | Aplati ou représenté sous forme de cellules séparées |
| Feuilles de calcul multiples | Convertir une feuille de calcul sélectionnée à la fois |
| Graphiques et formes | Ne fait pas partie d'une table de tuyaux |
| Commentaires et notes de cellule | Généralement non représenté |
| Les liens hypertexte | Peut nécessiter une révision manuelle ou une reconstruction |
Il ne s'agit pas d'un défaut du convertisseur.Les tableaux Markdown n'ont pas de syntaxe standard pour la plupart des fonctionnalités de présentation des feuilles de calcul.
Manipulation des cellules vides
Les cellules vides sont valables dans un tableau Markdown :
| Name | Email | Region |
| --- | --- | --- |
| Amina | amina@example.com | EMEA |
| Jordan | | North America |
Ne remplissez pas chaque cellule vide avec un tiret à moins que le tiret n'ait une signification définie.Dans la documentation des données, faites la distinction entre :
- vide : aucune valeur n'a été fournie ;
N/A: le champ ne s'applique pas ;Unknown: une valeur existe mais n'est pas connue ;0: la valeur mesurée est nulle.
Cette distinction empêche les lecteurs et les outils en aval d'interpréter mal le tableau.
Échappement des caractères de canalisation
Markdown utilise le caractère barre verticale (|) pour séparer les colonnes.Un tuyau littéral à l'intérieur d'une cellule doit normalement être échappé :
| Command | Meaning |
| --- | --- |
| `build \| deploy` | Run either stage according to the condition |
Si une ligne convertie crée de manière inattendue des colonnes supplémentaires, recherchez dans la source des tubes littéraux et remplacez chaque occurrence pertinente par \|.
Le Formateur de tableaux Markdown comprend les tuyaux échappés et est utile pour vérifier la source réparée.
Gestion des sauts de ligne à l'intérieur des cellules
Les tables de tubes standard Markdown n'ont pas de représentation portable pour les cellules multi-paragraphes.Différents moteurs de rendu traitent les sauts de ligne bruts et HTML différemment.
Utilisez l'une de ces approches :
- Réécrivez la cellule en une seule phrase concise.
- Remplacer une simple coupure visuelle par
<br>si la destination le permet en ligne HTML. - Déplacez les explications longues sous le tableau et faites référence au nom de la ligne.
- Convertissez chaque ligne en un en-tête et une liste à puces lorsque les cellules contiennent de la prose substantielle.
Par exemple, cette ligne de feuille de calcul est trop dense pour une table portable :
Service | Setup steps (five lines) | Limitations (three paragraphs) | Owner
Une section documentation est plus claire :
### Search service
- **Owner:** Platform team
- **Setup:** Configure the index, credentials, and scheduled refresh.
- **Limitations:** Does not index archived projects.
La qualité de la conversion s'améliore parfois lorsque vous arrêtez de forcer un contenu complexe dans un tableau.
Choix de l'alignement des colonnes
GitHub Aromatisé Markdown utilise des deux-points dans la ligne de séparation :
| Item | Quantity | Price |
| :--- | ---: | ---: |
| Keyboard | 2 | $120 |
| Monitor | 1 | $280 |
:---s'aligne à gauche.---:s'aligne à droite.:---:.
Utilisez l'alignement à droite pour les valeurs numériques que les lecteurs comparent verticalement.Utilisez l'alignement à gauche pour les noms et les descriptions.Il est préférable d’utiliser le centrage avec parcimonie, car il peut réduire la lisibilité dans les tableaux larges.
XLSX contre CSV contre TSV
Utiliser XLSX lorsque
- le classeur contient plusieurs feuilles de calcul ;
- vous devez choisir un onglet spécifique ;
- dépendent du formatage de la feuille de calcul pour l'affichage ;
- la source est maintenue en Excel.
Utiliser CSV lorsque
- les données constituent déjà un seul tableau plat ;
- un autre système exporte directemenCSVT¤ ;
- vous souhaitez un format d'échange simple ;
- compte plus que la présentation d'un classeur.
Utilisez le Convertisseur CSV en Markdown pour les données séparées par des virgules ou des tabulations.Il gère les champs entre guillemets, les délimiteurs intégrés et les guillemets échappés de manière plus fiable que le remplacement manuel des virgules par des barres verticales.
Utiliser TSV lorsque
- contiennent fréquemment des virgules ;
- vous copiez une plage rectangulaire à partir d'une feuille de calcul ;
- une exportation séparée par des tabulations est disponible.
TSV est souvent pratique pour les flux de travail du presse-papiers, car les applications de feuilles de calcul séparent naturellement les cellules copiées avec des onglets.
Pourquoi le copier-coller échoue parfois
Copier une petite plage Excel et la coller dans un éditeur de texte brut peut fonctionner, mais plusieurs problèmes peuvent se produire :
- sont converties en espaces ;
- créent des lignes inattendues ;
- des lignes masquées sont incluses ou exclues de manière inattendue ;
- changent en fonction des paramètres régionaux ;
- les grandes plages sont tronquées ;
- la première ligne n'est pas traitée comme un en-tête ;
- sont copiées sous forme de chaînes d'erreur visibles.
Pour deux ou trois lignes, la conversion manuelle est acceptable.Pour une vraie feuille de calcul, la sélection du fichier et de la feuille de calcul offre un flux de travail plus inspectable.
Préparation des tableaux pour GitHub
GitHub restitue les tables de tubes dans les fichiers Markdown, les problèmes, les demandes d'extraction et autres champs Markdown.Avant de valider une table générée :
- inclut une ligne d'en-tête ;
- laisser une ligne vide avant le tableau ;
- échappe aux tuyaux littéraux ;
- conserver chaque ligne sur une ligne source lorsque cela est possible ;
- utiliser un texte de lien descriptif ;
- évitez les tableaux si larges qu'ils ne peuvent pas être lus sur un écran étroit ;
- vérifie la différence rendue, pas seulement la source brute.
Si le tableau documente les données générées, indiquez comment et quand elles ont été générées.Cela aide les réviseurs à comprendre s'ils doivent modifier directement le Markdown ou mettre à jour la feuille de calcul et la régénérer.
Préparation des tableaux pour Obsidian et sites de documentation
Obsidian et la plupart des systèmes de documentation compatibles GFM prennent en charge les tables de canalisations standard, mais les extensions diffèrent.Les plug-ins bruts HTML, les cellules multilignes, l'alignement et les tableaux avancés ne sont pas également portables.
Pour les contenus devant se déplacer entre plusieurs destinations :
- Préférer la syntaxe de base des tables de canal.
- Évitez les fonctionnalités d'étendue de colonne spécifiques au moteur de rendu.
- Conservez les images et la longue prose en dehors des cellules.
- Test sur les mises en page de bureau et mobiles.
- Conservez le classeur d'origine lorsque la table doit être régénérée.
Portable Markdown est volontairement moins expressif que Excel.Cette limitation rend la source plus facile à stocker, comparer et réutiliser.
Un flux de travail de publication de feuilles de calcul reproductibles
Pour une équipe qui publie régulièrement des données de feuilles de calcul, définissez un processus simple :
- Maintenir les données faisant autorité dans Excel.
- Créer une feuille de calcul propre contenant uniquement des colonnes et des lignes publiables.
- Recalculer et enregistrez le classeur.
- Convertir la feuille de travail avec Excel vers Markdown.
- Le format le résultat avec le Formateur de tableaux Markdown.
- Résumé a modifié les valeurs dans le contrôle de version.
- Vue d'avant le tableau dans sa destination finale.
- Enregistrement le fichier source et la date de l'instantané.
Cela sépare la maintenance des données de la publication de contenu tout en gardant le tableau final consultable sous forme de texte brut.
FAQ
Est-ce que Markdown peut conserver les formules Excel ?
Non. Les tables Markdown stockent des valeurs de texte, pas des formules ou des dépendances de calcul.Conservez le classeur lorsque les formules doivent continuer à fonctionner.
Puis-je convertir un classeur Excel comportant plusieurs feuilles ?
Oui.L'outil Excel à Markdown répertorie les feuilles de calcul du classeur afin que vous puissiez sélectionner et convertir une feuille à la fois.
Le fichier Excel est-il téléchargé ?
L'outil WordToMD Excel lit le classeur dans votre navigateur.Cela ne nécessite pas de télécharger le classeur vers un backend de conversion.
Pourquoi la première ligne de la feuille de calcul est-elle devenue l'en-tête Markdown ?
Markdown nécessitent une ligne d'en-tête.Préparez la feuille de calcul pour que sa première ligne significative contienne les noms de colonnes.Supprimez les titres décoratifs et les lignes vides au-dessus.
Puis-je convertir des cellules fusionnées ?
Les cellules fusionnées n'ont pas d'équivalent direct dans les tableaux standards Markdown.Supprimez-les et répétez la valeur pertinente, ou reconcevez le contenu sous forme de sections et de listes.
Que faire avec une table très large ?
Supprimez les colonnes non essentielles, divisez le tableau par sujet ou convertissez chaque enregistrement en une petite section.Un tableau qui nécessite un défilement horizontal constant est généralement difficile à utiliser sur les appareils mobiles.
Dois-je utiliser CSV au lieu de XLSX ?
Utilisez CSV pour un seul ensemble de données plates ou une exportation automatisée.Utilisez XLSX lorsque vous devez effectuer une sélection parmi des feuilles de calcul ou conserver les valeurs d'affichage spécifiques à la feuille de calcul avant la conversion.
Conclusion de l'enquête
La conversion de Excel en Markdown est simple lorsque la feuille de calcul est un ensemble de données rectangulaire propre.Utiliser Excel vers Markdown pour sélectionner un classeur et une feuille de calcul localement, puis examiner les caractères spéciaux, les cellules vides, l'alignement et les colonnes larges.Utiliser CSV vers Markdown pour les données d'échange forfaitaires et le Formateur de tableaux Markdown pour faciliter la révision de la source générée.
Plus important encore, traitez Markdown comme l'instantané publié et Excel comme source de calcul.Cette division vous donne une documentation lisible sans prétendre qu'un tableau en texte brut peut remplacer une feuille de calcul.