Generator tabel Markdown

Tabele Markdown są wymagające: wystarczy jeden brakujący znak potoku lub nierówny wiersz separatora, a cała tabela wyświetli się jako zwykły tekst. Ten generator daje wizualną siatkę do wpisywania danych, pozwala wkleić CSV lub TSV z arkusza kalkulacyjnego i tworzy wyrównaną tabelę Markdown, w której kolumny są wyrównane już w źródle – znacznie łatwiej ją czytać w diffie i poprawić za pierwszym razem.

Jak stworzyć tabelę w Markdown

  1. 1

    Wybierz wiersze i kolumny

    Albo wklej plik CSV/TSV – narzędzie automatycznie wyznaczy wymiary.

  2. 2

    Wpisz zawartość komórek

    Kliknij w każdą komórkę. Klawisze Tab i strzałek umożliwiają nawigację jak w arkuszu kalkulacyjnym.

  3. 3

    Ustaw wyrównanie kolumn

    Do lewej (domyślnie), do środka lub do prawej dla każdej kolumny za pomocą wiersza nagłówka.

  4. 4

    Skopiuj wynik w formacie Markdown

    Narzędzie dopełnia znaki potoku do szerokości kolumny, aby źródło wyglądało schludnie.

Składnia tabel Markdown

Podstawowa tabela:

| Kolumna A | Kolumna B | Kolumna C |
|-----------|-----------|-----------|
| komórka 1 | komórka 2 | komórka 3 |
| komórka 4 | komórka 5 | komórka 6 |

Wyrównanie zadaje się dwukropkami w wierszu separatora:

| Lewo | Środek | Prawo |
|:-----|:------:|------:|
| a    | b      | c     |
  • :--- wyrównanie do lewej
  • :---: do środka
  • ---: wyrównanie do prawej

Co generator robi za ciebie

  • Dopełnia każdą komórkę do szerokości najdłuższego wpisu w danej kolumnie, aby znaki potoku wyrównały się w źródle. Nie wpływa to na wynik renderowania – Markdown ignoruje nadmiarowe spacje – ale osoby czytające diff będą ci wdzięczne.
  • Zmienia znaki potoku wewnątrz komórek na \|, aby komórka zawierająca a|b nie rozpadła się na dwie kolumny.
  • Zachowuje wyrównanie przy zmianie szerokości kolumn.
  • Przyjmuje wklejanie CSV i TSV; wykrywa pola w cudzysłowach oraz przecinki wewnątrz cudzysłowów.

Najczęstsze błędy

  • Wiersz separatora jest obowiązkowy. Tabele Markdown bez wiersza |---|---| są wyświetlane jako zwykły tekst.
  • Brak komórek wielowierszowych. Każdy wiersz to jedna linia; wstaw <br>, gdy potrzebujesz wewnętrznego podziału, ponieważ podziały wierszy Markdown wewnątrz komórek tabeli nie są obsługiwane.
  • Brak zagnieżdżonych tabel. Jeśli są konieczne, użyj HTML-a.
  • Puste komórki wymagają spacji (lub przynajmniej pustej pary znaków potoku). Unikaj bezpośredniego użycia ||.

Kiedy lepiej użyć HTML

Jeśli potrzebujesz colspan, rowspan, komórek wielowierszowych lub własnych klas CSS, właściwym narzędziem są tabele HTML. Większość parserów Markdown akceptuje surowy znacznik tabeli HTML wstawiony bezpośrednio w treści.

Gdzie tabele Markdown sprawdzają się dobrze

  • Pliki README na GitHub, GitLab i Gitea.
  • Opisy zgłoszeń (issue) i pull requestów (PR).
  • Obsidian, Bear oraz większość aplikacji do notatek.
  • Docusaurus, MkDocs, Hugo – wszystkie obsługują tabele GFM.

Najczęściej zadawane pytania

Nie natywnie. Do podziałów wiersza w tekście użyj <br>. W przypadku prawdziwej treści wielowierszowej (bloki kodu, listy w komórce) zastosuj <table> z HTML.

GFM nie obsługuje połączonych komórek. Jeśli potrzebujesz kodów colspan lub rowspan, użyj HTML w dokumencie Markdown – większość programów renderujących przekazuje kod <table> bez zmian.

Nie. Wygenerowany kod HTML jest identyczny niezależnie od tego, czy stosuje się wypełnienie, czy nie – wypełnienie to wyłącznie kwestia czytelności źródła.

Tak. Kopiowanie z arkusza kalkulacyjnego umieszcza w schowku dane w formacie TSV (wartości rozdzielane tabulacją). Generator rozpoznaje TSV i tworzy tabelę Markdown z tymi samymi wierszami i kolumnami.

Napisz \|. Większość parserów wyświetli wtedy dosłowny znak potoku bez przełamania granicy kolumny.

Powiązane narzędzia

Narzędzie jest dostępne w innych językach