Le CSV semble simple jusqu’à ce qu’une valeur contienne le séparateur. Découper chaque ligne sur les virgules fonctionne avec Alice,Active,10, mais échoue avec "Keyboard, compact" ou "1,999.00". Une conversion fiable doit d’abord analyser l’enregistrement CSV, puis produire le Markdown.
Commencer par des enregistrements CSV valides
Un analyseur CSV traite les séparateurs dans les champs entre guillemets comme du texte. Un guillemet à l’intérieur d’un tel champ est doublé :
Product,Description,Price
Keyboard,"Compact, wireless","$89.00"
Monitor,"27"" IPS display","$299.00"Le second enregistrement contient trois cellules, pas cinq. Avant une conversion importante, vérifiez le séparateur et l’encodage. Les tableurs exportent des virgules, des tabulations ou des points-virgules selon la région. DevToy détecte les entrées séparées par virgules et tabulations ; utilisez TSV quand les cellules contiennent beaucoup de virgules.
Convertir la grille analysée en Markdown
Un tableau Markdown a besoin d’une ligne d’en-tête et d’une ligne séparatrice :
| Product | Description | Price |
| :--- | :--- | ---: |
| Keyboard | Compact, wireless | $89.00 |
| Monitor | 27" IPS display | $299.00 |Alignez le texte et les identifiants à gauche, les statuts courts au centre et les nombres comparables à droite. L’alignement ne transforme pas une chaîne en nombre.
Échapper les caractères propres à Markdown
Les guillemets CSV et les échappements Markdown résolvent des problèmes différents. Une barre verticale littérale doit devenir \| avant la génération, sinon elle démarre une nouvelle colonne. La plupart des moteurs n’acceptent pas de retour à la ligne dans une cellule. Remplacez-le par un espace ou utilisez <br> si le HTML intégré est autorisé.
Ne supprimez pas tous les guillemets. L’analyseur retire uniquement les délimiteurs et transforme les guillemets doublés en guillemets littéraux.
Valider dans la destination
GitHub, GitLab et les générateurs de documentation n’implémentent pas exactement le même dialecte Markdown. Testez un petit échantillon dans la plateforme finale avant de traiter des milliers de lignes.
Pour les données sensibles, utilisez le générateur visuel de tableaux Markdown. L’analyse et la conversion restent dans le navigateur.