Da CSV a Frontmatter Markdown

Una riga di intestazione con i nomi dei campi seguita da una riga per ogni documento. Ogni riga di dati diventa un proprio blocco frontmatter ---, con le intestazioni di colonna come chiavi YAML, nell'ordine in cui appaiono le tue colonne.

Una cella contenente un elenco separato da virgola (come i tag) viene convertita in un vero array YAML, quindi "astro,blog" diventa ["astro", "blog"] invece di una singola stringa. Un valore con una sola virgola finale, come "astro,", viene lasciato come la stringa semplice che sembra essere, senza tentativi di interpretazione.

Una cella che è esattamente "true" o "false" diventa un vero booleano YAML, e un intero o decimale semplice diventa un vero numero - entrambi senza virgolette, così gli strumenti a valle li leggono come il loro tipo effettivo anziché come testo. Le date vengono citate come qualsiasi altra stringa: se una data semplice diventa un timestamp nativo dipende dal parser (il parser Ruby di Jekyll lo fa, molte librerie YAML JavaScript no), quindi citarla mantiene il valore prevedibile ovunque invece di rischiare una supposizione. Anche un numero con uno zero iniziale, come un CAP "0755", viene mantenuto tra virgolette, perché alcuni parser YAML leggono uno zero iniziale come notazione ottale e cambierebbero silenziosamente il suo valore.

Scegli il delimitatore corrispondente dal menu a tendina. Tutto il resto - campi tra virgolette, virgole incorporate tra virgolette, suddivisione degli elenchi - funziona allo stesso modo indipendentemente dal delimitatore che separa le tue colonne.

Passa il menu a tendina Carattere di citazione a virgoletta singola (') prima di generare. Il parser tratta quindi ' come tratta normalmente " - per citare un campo, per l'escape di una virgoletta incorporata raddoppiandola e per consentire virgole o interruzioni di riga all'interno di un valore citato.

Sì - imposta lo stile Array su "Blocco: elenco rientrato" e le celle separate da virgola vengono rese come elenco rientrato "- elemento" sotto la loro chiave invece che su una singola riga inline [a, b, c], con scelta di rientro a 2 o 4 spazi. Entrambi gli stili vengono interpretati come lo stesso valore array; è una preferenza di formattazione, non un cambiamento di comportamento.

Lo strumento genera comunque un blocco per essa: i valori extra oltre l'ultima colonna vengono scartati e i valori mancanti vengono trattati come vuoti, con una nota sopra i risultati che indica quali numeri di riga sono stati interessati, così puoi tornare indietro e correggere il CSV di origine se si è trattato di un errore.

No - genera solo il blocco frontmatter --- dalle tue colonne CSV. Il contenuto del corpo deve ancora essere scritto o incollato separatamente.

Un unico file frontmatter.md combinato contenente il blocco di ogni riga in ordine, separati dai propri delimitatori ---. Se hai bisogno di ogni riga come file separato, copia i blocchi singolarmente e salvali con nomi file distinti.

Sì - l'output è YAML standard tra delimitatori ---, lo stesso formato che tutti e tre (e la maggior parte degli altri generatori di siti statici) si aspettano in cima a un file di contenuto. Niente qui è specifico per un framework. Il menu a tendina "Carica esempio" include un CSV pronto per ciascuno di Astro, Jekyll, Hugo e Obsidian, usando i nomi dei campi frontmatter documentati da quella piattaforma, così puoi vedere nomi di colonna reali prima di collegare il tuo CSV.

No - l'analisi e la conversione avvengono interamente nel tuo browser. Le tue righe CSV non vengono mai inviate a un server, il che significa anche che non c'è alcun limite di dimensione file o numero di righe oltre a quello che il tuo browser può gestire.