CSV naar Markdown Converter

README-bestanden, beschrijvingen van pull requests en documentatiesites geven Markdown-tabellen prachtig weer, mits je de moeite neemt om de verticale strepen en streepjes met de hand te typen. Deze converter leest een CSV-bestand, neemt de eerste rij als kop en genereert een GitHub Flavored Markdown-tabel met de juiste scheidingsregel. Elke cel wordt omgeven door |-scheidingstekens, klaar om in een README of een pull-requestbeschrijving te plakken.

Hoe de tabel is opgebouwd

  1. 1

    Plak de CSV

    Standaard staat er een voorbeeld met drie kolommen; vervang het door je eigen gegevens.

  2. 2

    Kies het scheidingsteken

    Standaard een komma. Kies tab, puntkomma of pipe uit de lijst, passend bij je gegevens.

  3. 3

    Rij 1 is de kop

    De eerste rij wordt weergegeven als de Markdown-kop, gevolgd door de vereiste scheidingsregel `| --- | --- |`.

  4. 4

    Rijen opgevuld tot de breedte

    Als een gegevensrij minder cellen bevat dan de kop, vult de converter aan met lege strings om de tabel rechthoekig te houden.

Rendering, uitlijning en waar het werkt en waar het niet werkt

GitHub Flavored Markdown (GFM)-tabellen worden breed ondersteund, maar niet overal. Weten waar ze weergegeven worden, maakt het verschil tussen een strakke README en een muur van verticale strepen.

Ondersteund in

  • Pull requests en wiki’s op GitHub, GitLab en Bitbucket
  • De meeste statische sitegeneratoren (Docusaurus, VitePress, MkDocs Material)
  • Markdown-voorbeeldweergave in VS Code
  • Notion (via plakken als Markdown)

Niet ondersteund in

  • CommonMark zonder de GFM-extensie
  • Reddit (gebruikt een eigen subset)
  • Enkele verouderde wiki-engines (DokuWiki, MoinMoin)

Kolomuitlijning

GFM-tabellen ondersteunen links-, midden- en rechtsuitlijning met behulp van dubbele punten in de scheidingsregel. Deze converter genereert gewone ----scheidingstekens; als je uitlijning nodig hebt, verwerk het resultaat achteraf:

Syntaxis Effect
:--- Links uitlijnen
:---: Centreren
---: Rechts uitlijnen

Zoek en vervang de scheidingsregel door | :--- | :---: | ---: |, afgestemd op de kolommen die je wilt uitlijnen.

Tekens escapen in Markdown-cellen

  • Verticale strepen (|) binnen een cel moeten als \\| worden geëscaped om te voorkomen dat de cel wordt opgesplitst. De converter escapet ze niet automatisch, dus schoon je gegevens vooraf op als ze verticale strepen bevatten.
  • Regeleinden binnen een cel verstoren de GFM-weergave. Vervang ze door <br> vóór de conversie als je zachte regeleinden binnen een cel wilt.
  • Sterretjes, onderstrepingstekens en backticks gaan er ongewijzigd doorheen en worden geïnterpreteerd als Markdown-nadruk of code. Zet er een backslash voor als je ze letterlijk wilt weergeven.

Veelgestelde vragen

Niet standaard: de scheidingsregel is gewoon ---. Vervang deze na de conversie door :---, :---: of ---: om de kolom links, in het midden of rechts uit te lijnen.

Escape ze met een backslash vóór de conversie, zodat | wordt omgezet in \|. Anders behandelt de Markdown-renderer ze als kolomscheidingstekens en breekt de tabel.

GFM-tabellen worden weergegeven op GitHub, GitLab, de meeste statische sitegeneratoren en VS Code. Ze worden niet weergegeven op kaal CommonMark, Reddit of sommige oudere wiki’s zonder plug-in.

Ja, het CSV-bestand wordt naar onze server gestuurd zodat de converter de tabel kan maken. Het wordt niet opgeslagen en niet aan de paginalink toegevoegd.

Gerelateerde tools