Da CSV a Markdown

Cos'è la Conversione da CSV a Markdown?

Convertire CSV in una tabella Markdown è un'operazione comune per gli sviluppatori. CSV (Comma-Separated Values) memorizza dati tabulari come testo semplice, con ogni riga su una propria linea e i campi separati da un delimitatore come la virgola o il tabulatore. È il formato di esportazione predefinito per fogli di calcolo, client SQL e strumenti di analisi. I file CSV sono compatti e facili da generare, ma non hanno un modo integrato per controllare come i dati appaiono quando vengono visualizzati. Un file CSV aperto in un editor di testo è una sequenza di stringhe delimitate da virgole, leggibile dai computer ma difficile da scorrere per gli esseri umani.

Le tabelle Markdown risolvono questo problema di leggibilità. Sono definite dalla specifica GitHub Flavored Markdown (GFM) e supportate da GitHub, GitLab, Bitbucket, Notion, Obsidian e generatori di siti statici come Hugo e Jekyll — ovunque venga elaborato Markdown, vengono renderizzate come tabelle HTML pulite. La sintassi utilizza il carattere pipe per separare le colonne e una riga separatore obbligatoria di trattini tra l'intestazione e le righe del corpo.

Convertire CSV in una tabella Markdown significa avvolgere ogni riga nella sintassi delimitata da pipe e inserire la riga separatore dopo l'intestazione. La prima riga del CSV diventa l'intestazione della tabella, e ogni riga successiva diventa una riga del corpo. Hai bisogno di questo ogni volta che incolli dati strutturati in un README, nella descrizione di una pull request, in una pagina wiki o in qualsiasi sistema di documentazione Markdown.

Perché Usare Questo Strumento?

Questo convertitore analizza il CSV nel browser, costruisce immediatamente l'output della tabella Markdown e non trasmette mai i tuoi dati a un server.

Casi d'Uso da CSV a Markdown

Riferimento alla Sintassi delle Tabelle Markdown

Le tabelle Markdown seguono la specifica GitHub Flavored Markdown (GFM). Ogni tabella richiede una riga di intestazione, una riga separatore e una o più righe del corpo. La riga separatore controlla l'allineamento delle colonne.

CSV vs Tabella Markdown

Entrambi i formati rappresentano dati tabulari come testo semplice. CSV è pensato per i computer e le pipeline di dati; le tabelle Markdown sono pensate per gli esseri umani che leggono la documentazione.

Esempi di Codice

I seguenti esempi mostrano come convertire CSV in una tabella Markdown in modo programmatico in diversi linguaggi. Ognuno produce una tabella GFM valida.

const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')

const separator = '| ' + headers.map(() => '---').join(' | ') + ' |'
const headerRow = '| ' + headers.join(' | ') + ' |'
const bodyRows = rows.map(row =>
  '| ' + row.split(',').join(' | ') + ' |'
)

const markdown = [headerRow, separator, ...bodyRows].join('\n')
// → | name | age | city |
// → | --- | --- | --- |
// → | Alice | 30 | Berlin |
// → | Bob | 25 | Tokyo |

import csv
import io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.reader(io.StringIO(csv_string))
rows = list(reader)
headers = rows[0]

lines = []
lines.append('| ' + ' | '.join(headers) + ' |')
lines.append('| ' + ' | '.join('---' for _ in headers) + ' |')
for row in rows[1:]:
    lines.append('| ' + ' | '.join(row) + ' |')

print('\n'.join(lines))
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |
# → | Bob | 25 | Tokyo |

# With pandas (one-liner)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_markdown(index=False))

package main

import (
	"encoding/csv"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var lines []string

	lines = append(lines, "| "+strings.Join(headers, " | ")+" |")
	sep := make([]string, len(headers))
	for i := range sep {
		sep[i] = "---"
	}
	lines = append(lines, "| "+strings.Join(sep, " | ")+" |")

	for _, row := range records[1:] {
		lines = append(lines, "| "+strings.Join(row, " | ")+" |")
	}

	fmt.Println(strings.Join(lines, "\n"))
	// → | name | age | city |
	// → | --- | --- | --- |
	// → | Alice | 30 | Berlin |
	// → | Bob | 25 | Tokyo |
}

# Using Miller (mlr) — convert CSV to Markdown table
mlr --icsv --omarkdown cat data.csv
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |

# Using csvtomd (pip install csvtomd)
csvtomd data.csv

# Using pandas in a one-liner
python3 -c "
import pandas as pd, sys
print(pd.read_csv(sys.argv[1]).to_markdown(index=False))
" data.csv

Domande Frequenti