Konwerter CSV na Markdown

Pliki README, opisy pull requestów i serwisy z dokumentacją pięknie renderują tabele Markdown, o ile chce ci się ręcznie wpisywać pionowe kreski i myślniki. Ten konwerter czyta CSV, bierze pierwszy wiersz jako nagłówek i emituje tabelę GitHub Flavored Markdown z poprawnym wierszem separatora. Każda komórka jest otoczona separatorami |, gotowa do wklejenia do README lub opisu pull requesta.

Jak budowana jest tabela

  1. 1

    Wklej CSV

    Domyślnie trzykolumnowa próbka; zastąp ją swoimi danymi.

  2. 2

    Wybierz separator

    Domyślnie przecinek. Wybierz z listy tabulator, średnik albo pionową kreskę, dopasowując separator do danych.

  3. 3

    Wiersz 1 to nagłówek

    Pierwszy wiersz emitowany jest jako nagłówek Markdown, po którym następuje wymagana linia separatora `| --- | --- |`.

  4. 4

    Wiersze wypełnione do szerokości

    Jeśli wiersz danych ma mniej komórek niż nagłówek, konwerter dopełnia pustymi ciągami, by tabela pozostała prostokątna.

Renderowanie, wyrównanie oraz gdzie zadziała, a gdzie nie

Tabele GitHub Flavored Markdown (GFM) są szeroko wspierane, ale nie wszędzie. Wiedza o tym, gdzie się renderują, to różnica między schludnym README a ścianą pionowych kresek.

Wspierane w

  • Pull requestach i wiki GitHuba, GitLaba, Bitbucketa
  • Większości generatorów stron statycznych (Docusaurus, VitePress, MkDocs Material)
  • Podglądzie Markdown w VS Code
  • Notion (przez wklejenie jako markdown)

Niewspierane w

  • CommonMark bez rozszerzenia GFM
  • Reddit (używa własnego podzbioru)
  • Niektórych starych silnikach wiki (DokuWiki, MoinMoin)

Wyrównanie kolumn

Tabele GFM obsługują wyrównanie do lewej, do środka i do prawej za pomocą dwukropków w wierszu separatora. Ten konwerter emituje zwykłe separatory ---; jeśli potrzebujesz wyrównania, przetwórz wynik dalej:

Składnia Efekt
:--- Do lewej
:---: Do środka
---: Do prawej

Zamień operacją znajdź i zamień linię separatora na | :--- | :---: | ---: |, dopasowując do kolumn, które chcesz przechylić.

Znaki specjalne w komórkach Markdown

  • Znaki pionowej kreski (|) wewnątrz komórki muszą być poprzedzone ucieczką jako \\|, aby nie podzielić komórki. Konwerter nie poprzedza ich ucieczką automatycznie, więc oczyść je wcześniej, jeśli twoje dane zawierają pionowe kreski.
  • Znaki nowej linii wewnątrz komórki psują renderowanie GFM. Zastąp je <br> przed konwersją, jeśli chcesz miękkie podziały linii wewnątrz komórki.
  • Gwiazdki, podkreślenia i grawisy przechodzą; są interpretowane jako wyróżnienie Markdown lub kod. Poprzedź wiodącym ukośnikiem wstecznym, jeśli chcesz mieć je dosłownie.

Najczęściej zadawane pytania

Nie domyślnie: wiersz separatora to zwykłe ---. Zamień go na :---, :---: albo ---: po konwersji, by przypiąć kolumnę do lewej, do środka albo do prawej.

Poprzedź je ukośnikiem wstecznym przed konwersją, zamieniając | na \|. W przeciwnym razie renderer Markdown potraktuje je jako separatory kolumn i zepsuje tabelę.

Tabele GFM renderują się na GitHubie, GitLabie, większości generatorów stron statycznych i w VS Code. Nie renderują się na czystym CommonMark, Reddicie ani niektórych starych wiki bez wtyczki.

Tak. CSV jest wysyłany na nasz serwer, aby konwerter mógł zbudować tabelę. Nie jest przechowywany ani dodawany do linku strony.

Powiązane narzędzia