Convertitore da CSV a Markdown

I README, le descrizioni delle pull request e i siti di documentazione rendono le tabelle Markdown in modo eccellente, a patto che tu abbia voglia di scrivere a mano le pipe e i trattini. Questo convertitore legge un CSV, prende la prima riga come intestazione e genera una tabella Markdown di GitHub Flavored con la riga di separazione corretta. Ogni cella è racchiusa tra delimitatori |, pronta da incollare in un README o nella descrizione di una pull request.

Come viene costruita la tabella

  1. 1

    Incolla il CSV

    Di default è un campione a tre colonne; sostituiscilo con i tuoi dati.

  2. 2

    Scegli il delimitatore

    Virgola per impostazione predefinita. Scegli dall'elenco tab, punto e virgola o pipe in base ai tuoi dati.

  3. 3

    La riga 1 è l'intestazione

    La prima riga viene emessa come intestazione Markdown, seguita dalla riga di separazione richiesta `| --- | --- |`.

  4. 4

    Righe riempite a larghezza

    Se una riga di dati ha meno celle dell'intestazione, il convertitore riempie con stringhe vuote per mantenere la tabella rettangolare.

Rendering, allineamento e dove funzionerà e dove non funzionerà

Le tabelle di GitHub Flavored Markdown (GFM) sono ampiamente supportate ma non universali. Sapere dove si rendono fa la differenza tra un README nitido e un muro di pipe.

Supportato in

  • GitHub, GitLab, Bitbucket pull request e wiki
  • La maggior parte dei generatori di siti statici (Docusaurus, VitePress, MkDocs Material)
  • Anteprima Markdown di VS Code
  • Notion (tramite incolla come markdown)

Non supportato in

  • CommonMark senza l’estensione GFM
  • Reddit (usa il proprio sottoinsieme)
  • Alcuni motori wiki legacy (DokuWiki, MoinMoin)

Allineamento delle colonne

Le tabelle GFM supportano l’allineamento a sinistra, centro e destra tramite i due punti nella riga di separazione. Questo convertitore emette separatori semplici ---; se hai bisogno di allineamento, post-elabora:

Sintassi Effetto
:--- Allinea a sinistra
:---: Allinea al centro
---: Allinea a destra

Trova e sostituisci la riga di separazione con | :--- | :---: | ---: | corrispondente alle colonne che desideri inclinare.

Caratteri di citazione nelle celle Markdown

  • I caratteri pipe (|) all’interno di una cella devono essere sottoposti a escape come \\| per evitare di dividere la cella. Il convertitore non lo fa automaticamente, quindi pulisci i dati in anticipo se contengono delle pipe.
  • Le nuove righe all’interno di una cella interrompono il rendering GFM. Sostituiscile con <br> prima della conversione se desideri interruzioni di riga morbide all’interno di una cella.
  • Asterischi, trattini bassi e backtick passano inalterati e vengono interpretati come enfasi Markdown o codice. Anteponi una barra rovesciata se li vuoi letterali.

Domande frequenti

Non per impostazione predefinita: la riga di separazione è un semplice ---. Sostituiscila con :---, :---: o ---: dopo la conversione per fissare la colonna a sinistra, al centro o a destra.

Eseguine l’escape con una barra rovesciata prima della conversione, trasformando | in \|. Altrimenti il renderer Markdown li tratta come separatori di colonna e rompe la tabella.

Le tabelle GFM si rendono su GitHub, GitLab, la maggior parte dei generatori di siti statici e VS Code. Non si rendono su CommonMark semplice, Reddit o alcuni wiki legacy senza un plugin.

Sì. Il CSV viene inviato al nostro server perché il convertitore possa costruire la tabella. Non viene archiviato e non viene aggiunto al link della pagina.

Strumenti correlati