ViewCSVOtwórz lub wklej plik CSV, a obok opcji pojawi się tabela z kreskami pionowymi, gotowa do wklejenia w README, zgłoszeniu (issue) lub na stronie wiki. Znak | wewnątrz wartości jest zapisywany jako \|, więc nigdy nie podzieli komórki, podziały wiersza w komórce zamieniają się w <br>, a kolumny liczbowe są wyrównane do prawej. Plik jest konwertowany w Twojej przeglądarce i nigdy nie jest wysyłany na serwer.
Jak przekonwertować CSV do Markdown
- Kliknij Otwórz plik, upuść plik
.csv,.tsvlub.txtna narzędzie albo wybierz Wklej. Ogranicznik jest wykrywany automatycznie; jeśli zostanie źle rozpoznany, ustaw go, kodowanie lub opcję Pierwszy wiersz zawiera nazwy kolumn w sekcji Ustawienia importu. - Wybierz Wyrównanie kolumn i sposób zapisu w polu Podziały wierszy w komórkach. Karta Markdown pokazuje dokładnie ten tekst, który znajdzie się w pobranym pliku.
- Kliknij Kopiuj, aby wkleić tabelę bezpośrednio do GitHuba, GitLaba lub edytora, albo Pobierz Markdown, aby zapisać plik
.md.
Jeśli plik nie ma wiersza nagłówka, wyłącz opcję Pierwszy wiersz zawiera nazwy kolumn: tabele Markdown zawsze wymagają nagłówka, więc kolumny otrzymają nazwy Column 1, Column 2 i tak dalej. Aby zamiast tego wyświetlić te same dane jako tabelę na stronie internetowej, użyj narzędzia CSV do HTML.
Opcje tabeli Markdown
| Liczby do prawej, tekst domyślnie | Ustawienie domyślne. Kolumna jest wyrównana do prawej (---:) tylko wtedy, gdy każda niepusta wartość jest zwykłą liczbą; 00731 lub 12 kg sprawiają, że kolumna zachowuje domyślne wyrównanie programu wyświetlającego. |
|---|---|
| Domyślne (brak), Do lewej, Do środka, Do prawej | Stosuje jedno wyrównanie do wszystkich kolumn: zwykłe ---, :---, :---: lub ---: w wierszu separatora. |
| Zachowaj jako <br> | Podział wiersza w komórce staje się znacznikiem <br>, który GitHub i większość programów wyświetla jako nową linię w komórce. To ustawienie domyślne. |
| Zastąp spacją | Każdy podział wiersza zamienia się w jedną spację – dla programów, które usuwają kod HTML. |
| Poprzedzaj znaki Markdown ukośnikiem | Domyślnie włączone. Znaki *, _, [, ], <, >, #, ~ i grawis (backtick) dostają ukośnik wsteczny, więc wartość taka jak *fast* czy <b> jest wyświetlana tak, jak ją wpisano, zamiast stać się formatowaniem lub kodem HTML. Wyłącz tę opcję tylko wtedy, gdy komórki zawierają Markdown, który ma zostać wyrenderowany. |
| Wyrównaj kolumny w tekście źródłowym | Domyślnie włączone. Uzupełnia komórki spacjami, aby surowy plik .md wyglądał jak siatka. Szerokie znaki, np. chińskie, japońskie czy koreańskie, liczą się jako dwie kolumny. Wyłącz, aby uzyskać najmniejszy plik; wyrenderowana tabela wygląda tak samo. |
Kreski pionowe, podziały wiersza i zera wiodące
- Kreski pionowe i ukośniki wsteczne są zawsze poprzedzane ukośnikiem (
\|,\\), nawet przy wyłączonej opcji Poprzedzaj znaki Markdown ukośnikiem, bo niezabezpieczony znak|rozpocząłby nową komórkę. - Przecinki i podziały wiersza w cudzysłowie są odczytywane zgodnie z RFC 4180, więc
"Cable tidy, 3-pack"pozostaje w jednej komórce. Każda wartość zawierająca podział wiersza jest zliczana w komunikacie nad podglądem. - Wartości są zapisywane jako tekst:
00731zachowuje zera, a34.90końcowe zero. Nic nie jest zaokrąglane ani formatowane od nowa. - Pusty nagłówek staje się
Column 3, a powtórzony –name (2), więc każda kolumna ma inny nagłówek. - Programy wyświetlające Markdown usuwają spacje z początku i końca komórki, a tabela nie może zawierać list ani akapitów; takie treści trzymaj w osobnym dokumencie.
Gdy tabela Markdown wyświetla się nieprawidłowo
- Tekst pod tabelą dołącza do jej ostatniego wiersza. Tabela kończy się dopiero na pustej linii lub na początku innego bloku, więc zostaw pod nią pustą linię.
- Wszystkie wartości są w jednej kolumnie. Ogranicznik został źle rozpoznany. W ustawieniach importu wybierz przecinek, średnik, tabulator lub kreskę pionową i otwórz plik ponownie.
- **W wyniku przed
*lub_pojawiają się ukośniki wsteczne. To efekt zabezpieczania znaków w programie, który go nie interpretuje. Wyłącz opcję Poprzedzaj znaki Markdown ukośnikiem**, jeśli Twoje dane nie zawierają znaków formatowania wymagających ochrony. - Podziały wiersza wyświetlają się jako dosłowny znacznik. Program wyświetlający nie dopuszcza HTML. W polu Podziały wierszy w komórkach wybierz Zastąp spacją.
Limity i prywatność
Pliki do 25 MB, 100 000 wierszy lub 2 mln komórek otwierają się z podglądem pierwszych 200 wierszy na żywo. Większe pliki są konwertowane strumieniowo: plik jest odczytywany dwukrotnie we fragmentach (raz, aby zmierzyć kolumny i ich szerokości, i drugi raz, aby zapisać wynik), komunikat informuje, że pobrany plik obejmuje całość, a przycisk Kopiuj nie jest dostępny. Pojedynczy plik wynikowy może mieć najwyżej 4 GB.
Konwersja odbywa się w tle w tej karcie, więc strona cały czas reaguje, a Anuluj przerywa pracę. Plik CSV nigdy nie jest wysyłany na serwer. Aby przed konwersją sprawdzić duży plik, otwórz go w przeglądarce CSV.
Przykład: lista produktów jako tabela Markdown
Lista produktów z kodem SKU z zerem wiodącym, kreską pionową w nazwie, przecinkiem w cudzysłowie i dwuwierszową notatką, przekonwertowana z ustawieniami domyślnymi. Kolumna price jest wyrównana do prawej, bo każda wartość jest liczbą; sku nie, bo 00731 pozostaje tekstem.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Pytania i odpowiedzi
Czy wynik działa na GitHubie?
Tak. To tabela w składni GitHub Flavored Markdown: wiersz nagłówka, wiersz separatora z opcjonalnymi dwukropkami wyrównania i po jednej linii na każdy wiersz CSV. GitLab, Obsidian i większość generatorów stron statycznych odczytuje tę samą składnię.
Dlaczego w tekście źródłowym widzę `\|`?
Zwykły znak | kończy komórkę w tabeli Markdown. Ukośnik wsteczny informuje program wyświetlający, że kreskę pionową należy pokazać jako tekst, więc Desk lamp | brass pozostaje w jednej komórce.
Czy mogę przekonwertować tabelę Markdown z powrotem do CSV?
Nie na tej stronie. Konwertuje ona wyłącznie CSV i TSV do Markdown.