Obsah

Ako vytvoriť tabuľku v Markdown

Potrebujete informácie vhodne naformátovať? Poďme zistiť, ako ľahko a jednoducho vytvoriť tabuľku v dokumente Markdown. Pozrime sa na užitočné nástroje a profesionálne techniky.

Intro

Začnime tým, že zistíme, prečo sú tabuľky v dokumentoch markdown potrebné, a pozrieme sa na najpohodlnejšie spôsoby rýchleho a jednoduchého vloženia tabuľky do dokumentu markdown.

Tabuľky sa často používajú na usporiadanie a prezentáciu informácií jasným a stručným spôsobom. Možno ich použiť na zobrazenie údajov, porovnanie rôznych hodnôt alebo zobrazenie vzťahov medzi rôznymi informáciami.

Použitie tabuliek môže tiež pomôcť urobiť váš dokument vizuálne príťažlivejším a ľahšie čitateľným a zrozumiteľným, najmä ak máte veľa informácií na prezentáciu.

Tabuľky sú teda vždy užitočné na usporiadanie informácií spôsobom, ktorý je ľahko uchopiteľný na prvý pohľad.

Syntax

Preto neexistuje syntax na vytváranie tabuliek v čistom Markdown. Tabuľky sú podporované len v niektorých verziách Markdown, napríklad Markdown Extra alebo GitHub Flavored Markdown.

A tu nájdete dokumentáciu od GitHubu o organizovaní informácií vo forme tabuliek. Podporu tabuliek nájdeme aj v rozšírenej syntaxi Markdown.

Vytvorenie

Najjednoduchším a najrýchlejším spôsobom vytvorenia tabuľky markdown je použitie služby Markdown Table Generator alebo AnyWayData.

Pomocou týchto nástrojov môžete rýchlo a jednoducho vytvoriť tabuľku s pekným grafickým rozhraním a potom môžete výsledný text Markdown skopírovať do svojho súboru.

Na druhej strane syntax jazyka Markdown je dostatočne jednoduchá na to, aby ste si mohli tabuľky kresliť sami. Na oddelenie buniek sa používa pipe alebo zvislé lomítko ( | ) a na vytvorenie riadku záhlavia spojovník ( - ).

Tu je jednoduchý príklad kódu tabuľky:

1
2
3
4
5
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Cell 2   | Cell 3   |
| Row 2    | Cell 5   | Cell 6   |
| Row 3    | Cell 8   | Cell 9   |

Takýto kód sa v hotovom dokumente zobrazí v nasledujúcej podobe:

Column 1Column 2Column 3
Row 1Cell 2Cell 3
Row 2Cell 5Cell 6
Row 3Cell 8Cell 9

Upozorňujeme, že ak potrebujete použiť symbol zvislej čiary ako obsah vo vnútri bunky, musíte pre tento symbol napísať kód HTML: |.

1
2
3
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Cell 2   |👉 | |

Výsledok:

Column 1Column 2Column 3
Row 1Cell 2👉 |

Zarovnanie

Na riadenie zarovnania textu v stĺpcoch tabuľky môžete použiť dvojbodky ( : ). Všimnite si dvojbodky v riadku s pomlčkami. Text v kóde tabuľky je všade posunutý doľava, ale vo výsledku uvidíte, že je zarovnaný v smere, kam sme umiestnili dvojbodky.

1
2
3
4
5
| Left-Aligned  | Center Aligned  | Right Aligned |
|:------------- |:---------------:| -------------:|
| Row 1         | Cell 2          | Cell 3        |
| Row 2         | Cell 5          | Cell 6        |
| Row 3         | Cell 8          | Cell 9        |

V ľavom stĺpci sme použili dvojbodky len na ľavej strane, aby sa text v celom stĺpci zarovnával doľava. V strednom stĺpci sme použili dvojbodky na ľavej aj pravej strane, takže text v tomto stĺpci je vycentrovaný. A v pravom stĺpci sme použili dvojbodky len na pravej strane, takže celý text je zarovnaný doprava.

Left-AlignedCenter AlignedRight Aligned
Row 1Cell 2Cell 3
Row 2Cell 5Cell 6
Row 3Cell 8Cell 9

V rámci tabuliek môžeme používať aj niektoré z formátovaní markdown, na ktoré sme zvyknutí - odkazy, šikmý, tučný alebo prečiarknutý text.

1
2
3
4
5
6
| Left-Aligned  | Center Aligned  | Right Aligned |
|:------------- |:---------------:| -------------:|
| Row 1         | **Bold**        | Cell 3        |
| Row 2         | *Italic*        | Cell 6        |
| Row 3         | ~~Strike~~      | Cell 9        |
| Row 3         | [Link](dot.com) | Cell 9        |

Tabuľka s formátovaným textom vo vnútri:

Left-AlignedCenter AlignedRight Aligned
Row 1BoldCell 3
Row 2ItalicCell 6
Row 3StrikeCell 9
Row 3LinkCell 9

V tabuľke Markdown však nemôžete používať nadpisy, blokové úvodzovky, zoznamy, horizontálne oddeľovače, obrázky ani väčšinu iných značiek HTML.

Bez záhlavia

Niekedy je potrebné vytvoriť tabuľku Markdown bez záhlavia.

Takáto zdanlivo jednoduchá úloha si vyžaduje určitú kreativitu. Väčšina analyzátorov Markdown totiž nepodporuje tabuľky bez záhlavia. To znamená, že oddeľovač záhlavia je povinný.

Ak chcete vytvoriť tabuľku Markdown bez záhlavia, použite nasledujúci trik. Keďže hlavička je aj tak potrebná, namiesto textu stačí vložiť špeciálny kód komentára HTML <!-- -->:

1
2
3
4
5
| <!-- -->      | <!-- -->        | <!-- -->      |
|:-------------:|:---------------:|:-------------:|
| Row 1         | **Bold**        | Cell 3        |
| Row 2         | *Italic*        | Cell 6        |
| Row 3         | ~~Strike~~      | Cell 9        |

Výsledkom je tabuľka bez hlavičky:

Row 1BoldCell 3
Row 2ItalicCell 6
Row 3StrikeCell 9

Všimnite si, že to vo väčšine prípadov funguje, ale niektoré aplikácie môžu takýto kód stále zobrazovať nesprávne. Na StackOverflow sa nachádza otázka na túto tému a podrobné odpovede popisujúce rôzne možnosti vytvorenia takýchto tabuliek.

Zlučovanie

Niekedy môžeme potrebovať ešte sofistikovanejšie formátovanie tabuľky, keď potrebujeme spojiť viacero buniek v tabuľke. Napríklad takto:

Column 1Column 2Column 3
R1 TextR2 Text AR3 Text A
R3 Text B
R2 Text BR3 Text C
R3 Text D

Hneď na úvod poviem, že prakticky žiadna implementácia Markdown to nedokáže štandardnými prostriedkami nemožné. Pretože podľa špecifikácie: “Ak je počet buniek v tabuľke menší ako počet buniek v riadku záhlavia, potom vložte prázdne bunky. Ak je ich viac, potom sa prebytok ignoruje”.

Takže jediný spôsob, ako vytvoriť takúto tabuľku, ako je uvedené vyššie, je použiť čistý kód HTML. Príklad kódu pre vyššie uvedenú tabuľku:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<table>
    <thead>
        <tr>
            <th>Column 1</th>
            <th>Column 2</th>
            <th>Column 3</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td rowspan=4 align="center">R1 Text</td>
            <td rowspan=2 align="center">R2 Text A</td>
            <td align="center">R3 Text A</td>
        </tr>
        <tr>
            <td align="center">R3 Text B</td>
        </tr>
        <tr>
            <td rowspan=2 align="center">R2 Text B</td>
            <td align="center">R3 Text C</td>
        </tr>
        <tr>
            <td align="center">R3 Text D</td>
        </tr>
    </tbody>
</table>

Užitočné

Outro

Hoci sú tabuľky praktickým nástrojom na zobrazovanie informácií v dokumentoch Markdown, samotná syntax jazyka umožňuje pri vytváraní tabuliek v dokumentoch vykonávať len základné činnosti.

Pozreli sme sa na tieto základné funkcie a naučili sme sa, ako rýchlo a jednoducho vytvoriť tabuľku v dokumente Markdown. A pre komplikované prípady máme vždy k dispozícii starý dobrý kód HTML.

Veľa úspechov!

😎