Jak zrobić tabelę w Markdown:składnia, wyrównanie i komórki wieloliniowe.

Podstawowa składnia tabeli w Markdown

Tabele należą do GitHub Flavored Markdown (GFM), dialektu używanego przez GitHub, GitLab i większość aplikacji Markdown. Tabela potrzebuje trzech rzeczy:

1. Wiersz nagłówka

   Nazwy kolumn oddzielone kreskami pionowymi: | Nazwa | Rola |.

2. Wiersz rozdzielający

   Linia myślników, jedna grupa na kolumnę, tuż pod nagłówkiem: | --- | --- |. Musi mieć tyle komórek co nagłówek, inaczej tekst zostaje zwykłym tekstem i tabela się nie pojawia.

3. Wiersze

   Jedna linia na wiersz, komórki oddzielone kreskami pionowymi. Wiersz ze zbyt małą liczbą komórek jest uzupełniany pustymi; nadmiarowe komórki są odrzucane. Tabela kończy się na pierwszej pustej linii.

| Name  | Role     |
| ----- | -------- |
| Alice | Designer |
| Bob   | Engineer |

Tak widzi to czytelnik:

Kreski pionowe na początku i na końcu każdej linii są opcjonalne, ale ułatwiają czytanie tabeli. Kolumny nie muszą się równać w źródle; dopełnienie powyżej służy tylko ludziom. Komórki mogą zawierać pogrubienie, kursywę, kod, linki i obrazy.

Wyrównanie w tabeli Markdown

Postaw dwukropek z lewej, z prawej lub z obu stron myślników kolumny:

| Item   | Qty | Price |
|:-------|:---:|------:|
| Pencil |  12 |  $1.50 |
| Ruler  |   3 |  $4.00 |

Wyrównanie dotyczy całej kolumny, łącznie z nagłówkiem. Ustawia się je raz, w wierszu rozdzielającym, a nie komórka po komórce. Liczby wyrównuj do prawej, żeby cyfry leżały pod sobą.

Kreska pionowa lub druga linia w komórce

Kreska pionowa kończy komórkę, więc kreska będąca częścią tekstu wymaga ukośnika wstecznego. GFM stosuje to nawet wewnątrz kodu w linii:

| Command            | Meaning          |
|--------------------|------------------|
| `a \| b`           | a pipe, in code  |
| Either \| or       | a pipe, in text  |

Tabela z kreskami ma jedną linię na wiersz, więc komórka nie może zawierać prawdziwego złamania wiersza ani drugiego akapitu. Zwykle obchodzi się to znacznikiem HTML <br>:

| Step  | What to do                          |
|-------|-------------------------------------|
| Build | Run the build.<br>Fix any errors.  |
| Ship  | Tag the release.<br>Push the tag.  |

Ten sam trik daje wieloliniową komórkę na GitHubie i w większości innych aplikacji, które przyjmują HTML. Lista Markdown nie działa w komórce; jeśli komórka potrzebuje listy, wpisz <br> między krótkimi pozycjami albo wyprowadź listę poza tabelę.

Szerokie tabele i długi tekst

Markdown nie ma ustawienia szerokości kolumn ani sposobu łączenia komórek; o tym, jak tabela się zmieści, decyduje aplikacja, która ją pokazuje. Kilka nawyków utrzymuje czytelność tabeli wszędzie:

• Trzymaj komórki krótkie, słowo lub liczba. Długie wyjaśnienie umieść w zdaniu pod tabelą.
• Używaj mniej kolumn. Jeśli tabela ma osiem, obróć ją: kolumny niech będą pozycjami, a wiersze właściwościami.
• Nie dopełniaj źródła spacjami, by wyrównać kolumny w tabeli, którą często edytujesz; jedna zmieniona komórka oznaczałaby poprawianie odstępów w każdej linii.
• Dla połączonych komórek, rozciągniętych wierszy lub podpisu napisz tabelę w HTML. Większość aplikacji Markdown pokazuje zwykłe <table>.

Dlaczego tabela Markdown się nie wyświetla

• Brak wiersza rozdzielającego. To linia myślników czyni z tekstu tabelę.
• Liczba komórek się różni. Jeśli nagłówek ma trzy komórki, a wiersz rozdzielający dwie, nic się nie wyświetli.
• Kreska pionowa bez ucieczki w komórce dzieli ją na dwie. Napisz \|.
• Pusta linia wewnątrz tabeli. Tabela kończy się tam; reszta to zwykły tekst.
• Aplikacja nie obsługuje tabel. Tabel nie ma w oryginalnym Markdown ani w rdzeniu CommonMark. Pochodzą z GFM, więc minimalny parser pokazuje kreski jako tekst.

Aby zobaczyć wynik przed commitem, otwórz plik w czytniku Markdown. DotMD pokazuje wyrenderowane tabele i czytanie w nim jest bezpłatne. W DotMD Editor Insert → Table wstawia do pliku gotową tabelę o trzech kolumnach, a podgląd na żywo przerysowuje ją podczas pisania.

Pytania o tabele w Markdown

Więcej pytań