CSV till Markdown-omvandlare

README-filer, beskrivningar av pull requests och dokumentationssajter renderar Markdown-tabeller vackert, om du orkar handskriva pipe-tecknen och bindestrecken. Den här omvandlaren läser en CSV, tar den första raden som rubrik, och skickar ut en tabell i GitHub Flavored Markdown med rätt avgränsarrad. Varje cell omges av |-avgränsare, redo att klistra in i en README eller en pull-request-beskrivning.

Så byggs tabellen

  1. 1

    Klistra in CSV:en

    Förinställt på ett exempel med tre kolumner; byt ut det mot dina egna data.

  2. 2

    Välj avgränsare

    Komma som standard. Välj tabb, semikolon eller pipe från listan så att det matchar dina data.

  3. 3

    Rad 1 är rubriken

    Den första raden skickas ut som Markdown-rubriken, följd av den obligatoriska avgränsarraden `| --- | --- |`.

  4. 4

    Rader utfyllda till bredd

    Om en datarad har färre celler än rubriken fyller omvandlaren ut med tomma strängar för att hålla tabellen rektangulär.

Rendering, justering och var det fungerar och inte fungerar

Tabeller i GitHub Flavored Markdown (GFM) stöds brett men inte universellt. Att veta var de renderas är skillnaden mellan en skarp README och en vägg av pipe-tecken.

Stöds i

  • GitHub, GitLab, Bitbucket pull requests och wikis
  • De flesta statiska sajtgeneratorer (Docusaurus, VitePress, MkDocs Material)
  • VS Code Markdown-förhandsgranskning
  • Notion (via klistra-in-som-markdown)

Stöds inte i

  • CommonMark utan GFM-tillägget
  • Reddit (använder sin egen delmängd)
  • Vissa äldre wiki-motorer (DokuWiki, MoinMoin)

Kolumnjustering

GFM-tabeller stöder vänster-, mitt- och högerjustering via kolon i avgränsarraden. Den här omvandlaren skickar ut vanliga ----avgränsare; om du behöver justering, efterbearbeta:

Syntax Effekt
:--- Vänsterjustera
:---: Mittjustera
---: Högerjustera

Sök-och-ersätt avgränsarraden med | :--- | :---: | ---: | matchande de kolumner du vill luta.

Att citera tecken i Markdown-celler

  • Pipe-tecken (|) inuti en cell måste escapas som \\| för att undvika att cellen delas. Omvandlaren escapar dem inte automatiskt, så förstäda om dina data innehåller pipe-tecken.
  • Radbrytningar inuti en cell bryter GFM-renderingen. Ersätt dem med <br> före konvertering om du vill ha mjuka radbrytningar inuti en cell.
  • Asterisker, understreck och backticks passerar igenom; de tolkas som Markdown-betoning eller -kod. Escapa med ett inledande omvänt snedstreck om du vill ha dem bokstavliga.

Vanliga frågor

Inte som standard: avgränsarraden är vanlig ---. Ersätt den med :---, :---: eller ---: efter konvertering för att fästa kolumnen vänster, mitten eller höger.

Escapa dem med ett omvänt snedstreck före konvertering, så att | blir \|. Annars behandlar Markdown-renderaren dem som kolumnavgränsare och bryter tabellen.

GFM-tabeller renderas på GitHub, GitLab, de flesta statiska sajtgeneratorer och VS Code. De renderas inte på vanlig CommonMark, Reddit eller vissa äldre wikis utan ett plugin.

Ja, CSV:en skickas till vår server så att konverteraren kan bygga tabellen. Den sparas inte och läggs inte till i sidlänken.

Relaterade verktyg