ViewCSVOpen of plak een CSV-bestand en naast de opties verschijnt een pipe-tabel, klaar voor een README, een issue of een wikipagina. Een | binnen een waarde wordt geschreven als \|, zodat hij nooit een cel kan splitsen, regeleinden in een cel worden <br>, en kolommen met getallen worden rechts uitgelijnd. Het bestand wordt in je browser omgezet en nooit geüpload.
Zo zet je CSV om naar Markdown
- Kies Bestand openen, sleep een
.csv-,.tsv- of.txt-bestand naar de tool, of kies Plakken. Het scheidingsteken wordt herkend. Klopt de gok niet, stel dan het scheidingsteken, de codering of Eerste rij bevat kolomnamen in onder Importinstellingen. - Kies de Uitlijning van kolommen en hoe Regeleinden binnen cellen worden geschreven. Het tabblad Markdown toont precies de tekst die in de download komt.
- Kies Kopiëren om de tabel direct in GitHub, GitLab of je editor te plakken, of ‘Markdown downloaden’ om een
.md-bestand op te slaan.
Heeft je bestand geen kopregel, zet dan Eerste rij bevat kolomnamen uit. Een Markdown-tabel heeft altijd een kopregel nodig, dus de kolommen heten dan Column 1, Column 2 enzovoort. Wil je dezelfde gegevens als webtabel tonen, gebruik dan CSV naar HTML.
Wat elke optie doet
| Getallen rechts, tekst standaard | De standaard. Een kolom wordt alleen rechts uitgelijnd (---:) als elke niet-lege waarde een gewoon getal is; met 00731 of 12 kg erin houdt de kolom de standaarduitlijning van de renderer. |
|---|---|
| Standaard (geen), Links, Midden, Rechts | Eén uitlijning voor alle kolommen: gewoon ---, of :---, :---: of ---: in de scheidingsregel. |
| Behouden als <br> | Een regeleinde in een cel wordt <br>, wat GitHub en de meeste renderers tonen als nieuwe regel binnen de cel. Dit is de standaard. |
| Vervangen door een spatie | Elk regeleinde wordt één spatie, voor renderers die HTML weghalen. |
| Markdown-tekens escapen | Standaard aan. *, _, [, ], <, >, #, ~ en de backtick krijgen een backslash, zodat een waarde als *fast* of <b> wordt getoond zoals hij is getypt en geen opmaak of HTML wordt. Zet dit alleen uit als de cellen Markdown bevatten die je weergegeven wilt hebben. |
| Kolommen in de brontekst uitlijnen | Standaard aan. Vult cellen aan met spaties, zodat het ruwe .md-bestand als raster leesbaar is. Brede tekens, zoals Chinees, Japans of Koreaans, tellen als twee kolommen. Zet het uit voor de kleinste uitvoer; de weergegeven tabel ziet er hetzelfde uit. |
Hoe lastige gegevens worden verwerkt
- Pipes en backslashes worden altijd geëscapet (
\|,\\), ook als Markdown-tekens escapen uitstaat, want een|zonder escape zou een nieuwe cel beginnen. - Komma’s en regeleinden tussen aanhalingstekens worden gelezen volgens RFC 4180, dus
"Cable tidy, 3-pack"blijft in één cel. Elke waarde met een regeleinde wordt geteld in een melding boven het voorbeeld. - Waarden worden als tekst geschreven:
00731houdt zijn nullen en34.90de nul aan het eind. Er wordt niets afgerond of anders opgemaakt. - Een lege kolomnaam wordt
Column 3en een dubbelename (2), zodat elke kolom een eigen kop heeft. - Markdown-renderers halen spaties aan begin en eind van een cel weg, en een tabel kan geen lijsten of alinea’s bevatten. Zet zulke inhoud in een apart document.
Problemen oplossen
- Tekst na de tabel plakt aan de laatste rij vast. Een tabel eindigt pas bij een lege regel of het begin van een ander blok. Laat er dus een lege regel na.
- Alle waarden staan in één kolom. Het scheidingsteken is verkeerd geraden. Kies onder Importinstellingen komma, puntkomma, tab of verticale streep en open het bestand opnieuw.
- **Er staan backslashes vóór
*of_in het resultaat.** Dat is de escaping, in een renderer die er niets mee doet. Zet ‘Markdown-tekens escapen’ uit als je gegevens geen opmaaktekens bevatten die beschermd moeten worden. - Regeleinden verschijnen als letterlijke tag. De renderer staat geen HTML toe. Kies ‘Vervangen door een spatie’ bij ‘Regeleinden binnen cellen’.
Grenzen en privacy
Bestanden tot 25 MB, 100.000 rijen of 2 miljoen cellen openen met een live voorbeeld van de eerste 200 rijen. Grotere bestanden worden in delen omgezet: het bestand wordt twee keer in stukken gelezen (eerst om de kolommen en hun breedte te meten, dan om te schrijven), een melding zegt dat de download het hele bestand bevat, en Kopiëren wordt niet aangeboden. Eén uitvoerbestand is maximaal 4 GB.
Het omzetten gebeurt in een achtergrondproces in dit tabblad, zodat de pagina blijft reageren; met Annuleren stop je het. Het CSV-bestand wordt nooit naar een server gestuurd. Wil je een groot bestand controleren voordat je het omzet, open het dan in de CSV-viewer.
Voorbeeld
Een productlijst met een SKU met voorloopnullen, een pipe in een naam, een komma tussen aanhalingstekens en een notitie van twee regels, omgezet met de standaardinstellingen. price wordt rechts uitgelijnd omdat elke waarde een getal is; sku niet, omdat 00731 als tekst bewaard blijft.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Vragen en antwoorden
Werkt het resultaat op GitHub?
Ja. Het is een pipe-tabel in GitHub Flavored Markdown: een kopregel, een scheidingsregel met optionele dubbele punten voor de uitlijning, en één regel per CSV-rij. GitLab, Obsidian en de meeste generatoren voor statische sites lezen dezelfde syntaxis.
Waarom zie ik `\|` in de brontekst?
Een gewone | beëindigt een cel in een Markdown-tabel. De backslash vertelt de renderer dat de pipe als tekst moet worden getoond, zodat Desk lamp | brass in één cel blijft.
Kan ik een Markdown-tabel terugzetten naar CSV?
Niet op deze pagina. Die zet alleen CSV en TSV om naar Markdown.