DevToolPal
PL

Konwerter CSV na tabelę Markdown

Zamienia CSV lub TSV na starannie wyrównaną tabelę Markdown do plików README, dokumentacji i zgłoszeń na GitHubie.

Działa lokalnie, nic nie jest wysyłane

Opcje

Wejście

0 znaków · 0 B

Wynik

0 znaków · 0 B

Do czego służy

Ręczne pisanie tabel Markdown jest żmudne: każdy wiersz wymaga kresek pionowych, drugi wiersz myślników, a ręczne wyrównywanie kolumn trwa wieki. To narzędzie zamienia dane CSV lub TSV na tabelę GitHub Flavored Markdown, którą możesz wkleić do README, pull requesta, zgłoszenia, wiki lub dowolnej dokumentacji w Markdown.

CSV jest poprawnie parsowany, więc obsługiwane są pola w cudzysłowach z przecinkami, podwojone cudzysłowy i komórki wielowierszowe. Wynik jest uzupełniany spacjami, aby kolumny były wyrównane również w zwykłym tekście — dzięki temu tabelę łatwo później czytać i edytować.

Jak używać

  1. Wklej CSV lub TSV, wgraj plik .csv lub .tsv albo kliknij Przykład.
  2. Wybierz Wyrównanie: domyślne, do lewej, do środka, do prawej albo Liczby do prawej, aby wyrównać do prawej kolumny zawierające tylko liczby.
  3. Zostaw włączone Pierwszy wiersz to nagłówek, jeśli pierwszy wiersz zawiera nazwy kolumn; w przeciwnym razie nagłówkiem będą Column 1, Column 2 itd.
  4. Wyłącz Wyrównaj kolumny, jeśli wolisz zwarte wiersze bez dopełnienia.
  5. Skopiuj tabelę lub pobierz ją jako plik .md.

Wiersze z mniejszą liczbą komórek niż nagłówek są uzupełniane pustymi komórkami, więc tabela zawsze jest poprawna.

Przykład

Taki plik CSV:

Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier

przy wyrównaniu Liczby do prawej zamienia się w taką tabelę Markdown:

| Tool    | Stars | Notes                  |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd      | 34000 | find \| but friendlier |

Przecinek w polu w cudzysłowie zostaje w komórce, kreska pionowa jest escapowana, a kolumna liczbowa dostaje znacznik --:, dzięki czemu po wyrenderowaniu jest wyrównana do prawej.

Wskazówki

  • Znaczniki wyrównania w drugim wierszu (:--, :-:, --:) decydują o wyrównaniu każdej kolumny w wyrenderowanej tabeli.
  • Markdown w treści komórek, np. **pogrubienie**, kod w linii czy linki, zostaje zachowany i większość przeglądarek go renderuje.
  • Bardzo szerokie tabele trudno czytać na małych ekranach; rozważ podzielenie kolumn na kilka tabel.
  • Aby utworzyć tabelę HTML lub zamienić tablicę JSON na tabelę Markdown, skorzystaj z powiązanych narzędzi poniżej.

FAQ

› Jakiego wariantu Markdown używa tabela?

Tabel z kreskami pionowymi z GitHub Flavored Markdown (GFM), obsługiwanych też przez GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs i większość generatorów stron statycznych. Czysty CommonMark nie ma składni tabel.

› Co dzieje się z kreskami pionowymi i znakami nowego wiersza w komórkach?

Kreska pionowa zakończyłaby komórkę, więc zapisuje się ją jako \|. W wierszu tabeli nie można łamać linii, dlatego znaki nowego wiersza zamieniają się w znaczniki <br>, które GitHub i większość rendererów wyświetla jako podział wiersza.

› Dlaczego kolumny po chińsku, japońsku czy koreańsku są wyrównane?

Przy włączonym Wyrównaj kolumny komórki są uzupełniane według szerokości wyświetlania: szerokie znaki wschodnioazjatyckie liczą się jako dwie kolumny, więc surowy Markdown pozostaje wyrównany w edytorze z czcionką o stałej szerokości. Wyrenderowana tabela wygląda tak samo w obu przypadkach.

› Czy mogę przekonwertować TSV skopiowany z Excela lub Arkuszy Google?

Tak. Komórki skopiowane z arkusza są rozdzielone tabulatorami, a separator jest wykrywany automatycznie. Możesz też jawnie wybrać tabulator.