Generator tabeli Markdown

Generator tabeli Markdown

Tabela Markdown to kilka linii zwykłego tekstu: wiersz nagłówka, wiersz separatora z myślnikami i wiersze danych, a komórki oddziela znak |. Takie tabele renderują się na GitHubie, GitLabie, w Obsidianie i w wielu systemach dokumentacji. Generator buduje je z danych wpisanych ręcznie, wklejonych z Excela lub z pliku CSV, więc nie trzeba niczego wyrównywać ręcznie.

Składnia

Kolumny oddziela się znakiem |, a wiersz z myślnikami oddziela nagłówek od danych:

| Nazwa | Cena |
| --- | ---: |
| Laptop | 4299 |

Wyrównanie

Tryb automatyczny

Tryb „Auto” wyrównuje do prawej kolumny, w których każda niepusta komórka jest liczbą, a pozostałe do lewej. Spacje między cyframi i przecinek dziesiętny są dozwolone, więc 4 299,99 liczy się jako liczba. Wystarczy jedna komórka typu 12 zł albo 15%, żeby cała kolumna została potraktowana jako tekst. Narzędzie startuje z wyrównaniem do lewej, ale dla tabel z cenami i ilościami tryb „Auto” zwykle daje czytelniejszy wynik.

Jak działa generator tabeli Markdown

Nazwy kolumn wpisujesz w osobnym polu, rozdzielone przecinkami. Każda linia w polu danych to jeden wiersz tabeli, a puste linie są pomijane. Wartości w wierszu rozdzielasz średnikiem, znakiem | albo tabulatorem (ten trafia do schowka przy kopiowaniu zakresu z Excela lub Arkuszy Google). Dla danych CSV wybierz separator „Przecinek”: wtedy wartość w cudzysłowie, np. "Laptop, 15 cali", zostaje jedną komórką. Jeśli wklejasz zakres razem z nagłówkiem, zaznacz „Pierwsza linia danych to nazwy kolumn”.

Tabela Markdown wymaga tej samej liczby komórek w każdym wierszu. Generator liczy kolumny z nagłówka: krótsze wiersze uzupełnia pustymi komórkami, a nadmiarowe wartości odcina. W obu przypadkach wyświetla ostrzeżenie z numerem wiersza, więc od razu widać, gdzie w danych brakuje separatora albo jest o jeden za dużo. Znak |, który zostaje w treści komórki (np. w nazwie kolumny albo w danych CSV), dostaje ukośnik i nie rozbija wiersza na dodatkowe kolumny.

Wiersz separatora zawsze trafia między nagłówek a dane, ze znacznikami wyrównania dla każdej kolumny. Wyrównanie w Markdown opisuje całą kolumnę, więc nie da się go ustawić osobno dla jednego wiersza. Opcja „Wyrównaj kolumny spacjami w kodzie” dopełnia komórki spacjami do szerokości najdłuższej wartości w kolumnie (najmniej 3 znaki). To poprawia tylko czytelność pliku źródłowego: renderer sam ustala szerokości, więc na stronie tabela wygląda tak samo z tą opcją i bez niej.

Wynik możesz pobrać jako Markdown albo jako kod HTML <table> z sekcjami <thead> i <tbody>; wyrównanie do środka i do prawej trafia wtedy do stylu text-align komórek. Pod kodem widać podgląd wyrenderowanej tabeli oraz liczbę wierszy, kolumn, znaków i linii kodu. Jednorazowo narzędzie przyjmuje do 30 000 znaków danych, 500 wierszy i 40 kolumn.

Przykład krok po kroku

1. W polu nazw kolumn wpisz Produkt, Cena, Ilość.
2. W polu danych dodaj trzy wiersze: Laptop; 4299; 3, Monitor; 899; 12, Klawiatura; 249; 25.
3. Wybierz wyrównanie „Auto”. Kolumna Produkt zawiera tekst, więc zostaje przy lewej krawędzi, a Cena i Ilość mają same liczby, więc trafiają do prawej.
4. Przy włączonym wyrównaniu spacjami kolumny mają szerokość 10, 4 i 5 znaków (najdłuższe wartości to „Klawiatura”, „Cena” lub „4299” oraz „Ilość”). Wiersz separatora ma postać | ---------- | ---: | ----: |.
5. Pod separatorem są trzy wiersze danych, każdy z trzema komórkami, np. | Laptop | 4299 | 3 |, w kodzie dopełniony spacjami do szerokości kolumn.
6. Kopiujesz wynik przyciskiem „Kopiuj kod” i wklejasz do pliku .md, README albo komentarza na GitHubie.

Elementy tabeli Markdown i ich rola

Praktyczne wskazówki

• Zacznij od trybu automatycznego i przełącz wyrównanie ręcznie tylko wtedy, gdy wynik nie pasuje, na przykład dla numerów zamówień, które wyglądają jak liczby, ale lepiej czyta się je przy lewej krawędzi.
• Trzymaj w komórce pojedynczą wartość, a jednostkę przenieś do nazwy kolumny („Cena [zł]”). Kolumna z samymi liczbami zostanie wtedy rozpoznana jako liczbowa.
• Pustą komórkę w środku wiersza zaznacz dwoma separatorami obok siebie, np. Mysz;;40. Brakująca wartość na końcu wiersza zostanie uzupełniona automatycznie, ale pominięta w środku przesunęłaby kolejne dane o kolumnę.
• Gotową, nierówną tabelę Markdown możesz wkleić do pola danych: zewnętrzne kreski i stary wiersz separatora zostaną usunięte, a tabela przeformatowana od nowa.
• Przed publikacją zobacz tabelę tam, gdzie ma się wyświetlić, bo nie każdy renderer respektuje znaczniki wyrównania.

Ograniczenia i czynniki zaburzające wynik

• Scalone komórki: Markdown ich nie obsługuje, więc generator nie połączy nagłówków ani wierszy. Taki efekt wymaga surowego HTML w pliku.
• Komórka nie może mieć kilku linii. Złamanie wiersza zapisuje się znacznikiem <br> wewnątrz komórki, o ile platforma dopuszcza HTML.
• Tabele są rozszerzeniem GFM (GitHub Flavored Markdown), a nie częścią podstawowej składni. Część platform ich nie wyświetla albo wymaga pustej linii przed tabelą.
• Liczby w formacie 1.234,56 (kropka jako separator tysięcy) albo z jednostką nie są rozpoznawane jako liczbowe. Wtedy ustaw wyrównanie ręcznie.
• Gwiazdki, podkreślenia czy grawisy w treści renderer może potraktować jako formatowanie tekstu i zmienić wygląd komórki.