Wat het doet
Markdown-tabellen met de hand typen is saai: elke rij heeft verticale strepen nodig, de tweede regel streepjes, en kolommen handmatig uitlijnen duurt eeuwen. Deze tool zet CSV- of TSV-gegevens om naar een tabel in GitHub Flavored Markdown die je kunt plakken in een README, pull request, issue, wiki of andere Markdown-documentatie.
De CSV wordt correct geparst, dus velden tussen aanhalingstekens met komma’s, verdubbelde aanhalingstekens en cellen over meerdere regels worden verwerkt. De uitvoer wordt aangevuld met spaties zodat de kolommen ook in platte tekst uitgelijnd zijn; zo is de tabel later makkelijk te lezen en te bewerken.
Zo gebruik je het
- Plak CSV of TSV, upload een
.csv- of.tsv-bestand, of klik op Voorbeeld. - Kies de Uitlijning: standaard, links, midden, rechts of Getallen rechts om kolommen met alleen getallen rechts uit te lijnen.
- Laat Eerste rij is kopregel aan als de eerste rij de kolomnamen bevat; anders wordt de kop Column 1, Column 2 enzovoort.
- Zet Kolommen uitlijnen uit als je compacte rijen zonder opvulling wilt.
- Kopieer de tabel of download hem als
.md-bestand.
Rijen met minder cellen dan de kopregel worden aangevuld met lege cellen, dus de tabel is altijd geldig.
Voorbeeld
Deze CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier
wordt met de uitlijning Getallen rechts deze Markdown-tabel:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |
De komma in het veld tussen aanhalingstekens blijft in de cel, de verticale streep wordt geëscaped en de getallenkolom krijgt de markering --:, zodat hij rechts wordt uitgelijnd in de weergave.
Tips
- De uitlijningsmarkeringen in de tweede rij (
:--,:-:,--:) bepalen hoe elke kolom in de weergegeven tabel wordt uitgelijnd. - Inline Markdown in cellen, zoals
**vet**, inline code of links, blijft behouden en wordt door de meeste viewers weergegeven. - Zeer brede tabellen zijn op kleine schermen lastig te lezen; overweeg de kolommen over meerdere tabellen te verdelen.
- Wil je een HTML-tabel maken of een JSON-array omzetten naar een Markdown-tabel, gebruik dan de gerelateerde tools hieronder.
Veelgestelde vragen
› Welke Markdown-variant gebruikt de tabel?
Pipe-tabellen uit GitHub Flavored Markdown (GFM), die ook worden ondersteund door GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs en de meeste statische sitegenerators. Kale CommonMark heeft geen tabelsyntaxis.
› Wat gebeurt er met verticale strepen en regeleinden in cellen?
Een verticale streep zou de cel beëindigen, dus die wordt geschreven als \|. Regeleinden zijn niet toegestaan binnen een tabelrij, dus worden ze <br>-tags, die GitHub en de meeste renderers als regeleinde tonen.
› Waarom worden kolommen met Chinees, Japans of Koreaans netjes uitgelijnd?
Met Kolommen uitlijnen aan worden cellen aangevuld op weergavebreedte: brede Oost-Aziatische tekens tellen als twee kolommen, zodat de Markdown uitgelijnd blijft in een editor met een monospace-lettertype. De weergegeven tabel ziet er in beide gevallen hetzelfde uit.
› Kan ik TSV omzetten dat ik uit Excel of Google Spreadsheets heb gekopieerd?
Ja. Cellen die uit een spreadsheet zijn gekopieerd, worden gescheiden door tabs en het scheidingsteken wordt automatisch herkend. Je kunt Tab ook expliciet kiezen.