Jak udělat tabulku v Markdownu:syntaxe, zarovnání a víceřádkové buňky.

Základní syntaxe tabulky v Markdownu

Tabulky jsou součástí GitHub Flavored Markdownu (GFM), dialektu, který používá GitHub, GitLab a většina aplikací pro Markdown. Tabulka potřebuje tři věci:

1. Řádek záhlaví

   Názvy sloupců oddělené svislítky: | Name | Role |.

2. Oddělovací řádek

   Řádek pomlček, jedna skupina na sloupec, přímo pod záhlavím: | --- | --- |. Musí mít stejně buněk jako záhlaví, jinak zůstane text obyčejným textem a tabulka se neobjeví.

3. Řádky tabulky

   Jeden řádek na záznam, buňky oddělené svislítky. Řádek s příliš málo buňkami se doplní prázdnými, přebývající buňky se zahodí. Tabulka končí prvním prázdným řádkem.

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

Takhle to vidí čtenář:

Svislítka na začátku a na konci každého řádku jsou nepovinná, ale tabulka se s nimi čte snáz. Sloupce ve zdroji nemusí být zarovnané: odsazení výše je jen pro lidi. V buňkách může být tučné písmo, kurzíva, kód, odkazy a obrázky.

Zarovnání v tabulce Markdownu

Dvojtečku dejte vlevo, vpravo nebo na oba konce pomlček sloupce:

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

Zarovnání platí pro celý sloupec včetně záhlaví. Nastavuje se jednou v oddělovacím řádku, ne po buňkách. Čísla zarovnávejte vpravo, aby si číslice odpovídaly.

Svislítko nebo druhý řádek v buňce

Svislítko ukončuje buňku, takže svislítko, které je součástí textu, potřebuje zpětné lomítko. GFM to vyžaduje i uvnitř kódu v textu:

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

Tabulka se svislítky má jeden řádek na záznam, takže buňka nemůže obsahovat skutečné zalomení řádku ani druhý odstavec. Obvyklé řešení je HTML značka <br>:

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

Stejný trik dá víceřádkovou buňku na GitHubu a ve většině dalších aplikací, které přijímají HTML. Seznam v Markdownu v buňce nefunguje: pokud buňka potřebuje seznam, dejte <br> mezi krátké položky nebo seznam z tabulky přesuňte.

Široké tabulky a dlouhý text

Markdown nemá nastavení šířky sloupce ani slučování buněk; jak se tabulka vejde, rozhoduje aplikace, která ji zobrazuje. Pár návyků udrží tabulku čitelnou všude:

• Buňky mějte krátké, slovo nebo číslo. Dlouhé vysvětlení dejte do věty pod tabulku.
• Používejte méně sloupců. Pokud jich má tabulka osm, otočte ji: sloupce budou položky a řádky jejich vlastnosti.
• Nezarovnávejte zdroj mezerami u tabulky, kterou často upravujete; jedna změněná buňka by znamenala přeodsadit každý řádek.
• Pro sloučené buňky, buňky přes více řádků nebo popisek napište tabulku v HTML. Většina aplikací pro Markdown zobrazí obyčejné <table>.

Proč se tabulka v Markdownu nevykreslí

• Chybí oddělovací řádek. Řádek pomlček dělá z textu tabulku.
• Počty buněk se liší. Pokud má záhlaví tři buňky a oddělovač dvě, nevykreslí se nic.
• Neescapované svislítko v buňce ji rozdělí na dvě. Napište \|.
• Prázdný řádek uvnitř tabulky. Tabulka tam končí, zbytek je obyčejný text.
• Aplikace tabulky neumí. Tabulky nejsou v původním Markdownu ani v jádru CommonMarku. Pocházejí z GFM, takže minimální parser zobrazí svislítka jako text.

Chcete-li vidět výsledek před commitem, otevřete soubor v čtečce Markdownu. DotMD zobrazuje tabulky vykreslené a čtení je zdarma. V DotMD Editoru příkaz Insert → Table vloží do souboru hotovou tabulku o třech sloupcích a živý náhled ji při psaní překresluje.

Otázky k tabulkám v Markdownu

Další otázky