Convertir du JSON en tableau Markdown

Convertir du JSON en tableau Markdown: usages et conseils pratiques

Une table Markdown déplace une collection JSON dans une documentation, des notes ou un fichier lisible sans organiser manuellement les lignes. L'entrée doit être un tableau d'objets, tels que des enregistrements exportés ou une réponse d'échantillon. Les colonnes collectent les clés de chaque ligne au lieu du premier objet. Un membre apparaissant plus tard introduit une colonne à travers la table complète. La sortie contient une ligne d'en-tête, une ligne de séparateur et une ligne pour chaque objet, prêt à copier ou télécharger en tant que .md. Il s'agit d'une représentation des enregistrements fournis plutôt que d'une analyse ou d'un résumé de leurs valeurs.

Les valeurs utilisent des représentations lisibles. Les nombres et les booléens sont affichés sous forme de texte ; les chaînes conservent leur contenu ; les objets imbriqués et les tableaux deviennent des JSON compacts dans la cellule. Les membres manquants et null produisent des cellules vides, de sorte que ces cas ne sont pas distingués par le tableau. Si cette distinction est importante pour un rapport, préparez des étiquettes explicites avant la conversion. Les codes avec des zéros en tête doivent déjà être des chaînes dans le JSON source. La conversion d'un nombre analysé ne peut pas restaurer un format de texte qui a été perdu auparavant. Inspectez la représentation de la source avant d'utiliser l'apparence de la table comme preuve des types de données originaux.

Les caractères qui pourraient introduire du HTML, des séparateurs verticaux ou la syntaxe Markdown à l'intérieur d'une cellule sont échappés. L'objectif est d'afficher des valeurs plutôt que de les transformer en liens, images ou formatage supplémentaire. Les sauts de ligne intégrés deviennent le symbole , de sorte que chaque enregistrement reste sur une ligne de document physique. Les onglets deviennent des espaces. Cela rend la sortie plus facile à coller, mais n'est pas une transformation réversible de chaque détail d'espacement. Passez en revue les longues descriptions, les échantillons de code et les valeurs contenant des caractères spéciaux. Contenu utilisateur n'est pas présenté comme un aperçu HTML rendu dans cette page, gardant la conversion axée sur un artefact de texte pour une utilisation ailleurs.

L'apparence finale dépend de la visionneuse Markdown. Certains télélecteur PDFs ne supportent pas les tables ou n'affichent pas les espaces blancs différemment, alors vérifiez le fichier où il sera réellement lu. Les limites sont de mille lignes, cinquante colonnes et un million de caractères d'entrée, avec une structure JSON délimitée. Les clés en double et les entiers dangereux sont rejetés pour éviter les membres ambigus ou la perte de précision numérique silencieuse. Sélectionnez les colonnes nécessaires avant de convertir un jeu de données très large. Le tableau ne calcule pas les totaux ou les lignes agrégées : chaque ligne représente son objet original. Conservez JSON lorsque les champs peuvent avoir besoin d'être modifiés ou lorsqu'une exportation CSV ultérieure doit conserver les distinctions que la présentation Markdown n'affiche pas.