--- contributors: - ["Dan Turkel", "http://danturkel.com/"] translators: - ["Michal Martinek", "https://github.com/MichalMartinek"] - ["Tomáš Hartman", "https://github.com/tomas-hartman"] filename: markdown-cz.md --- Markdown byl vytvořen Johnem Gruberem v roce 2004 jako značkovací jazyk, který lze snadno číst a psát a který je možné jednoduše převést do HTML (a dnes i do mnoha dalších formátů). Implementace markdownu se v různých parserech (syntaktických analyzátorech, které markdown dále zpracovávají) mírně odlišuje. V této příručce se snažíme upozorňovat, kdy se jedná o obecnou vlastnost markdownu a kdy se jedná o specifickou vlastnost daného parseru. ## HTML Elementy Markdown je nadstavba HTML. To znamená, že každý HTML kód je zároveň validním kódem v Markdownu. ```md <!-- To znamená, že v Markdownu můžeme používat HTML elementy jako například komentáře, které nebudou ovlivněny parserem Markdownu. Na druhou stranu to také znamená, že pokud ve svém Markdown kódu vytvoříte HTML element, už v rámci tohoto elementu nelze použít Markdown. Markdown využívá i tato stránka, a tak by tento text, kdyby nebyl obalen v bloku kódu (viz níže), jako validní HTML komentář vůbec nebyl vidět. --> ``` ## Nadpisy HTML elementy `<h1>` až `<h6>` vytvoříte jednoduše tak, že nadpisu předsadíte takový počet křížků (#), jaký odpovídá úrovni nadpisu. ```md # Toto je <h1> ## Toto je <h2> ### Toto je <h3> #### Toto je <h4> ##### Toto je <h5> ###### Toto je <h6> ``` Markdown obsahuje ještě dva další způsoby, jak vytvořit h1 a h2: ```md Toto je h1 ========== Toto je h2 ---------- ``` ## Jednoduché stylování textu Pomocí markdownu můžete text jednoduše označit jako kurzívu či tučný text. ```md *Tento text je kurzívou;* _Stejně jako tento._ **Tento text je tučně** __Stejně jako tento.__ ***Tento text je obojí*** **_Tak jako tento!_** *__Nebo tento!__* ``` Ve verzi Markdownu od GitHubu máme k dispozici také přeškrtnutí: ```md ~~Tento text je přeškrtnutý.~~ ``` ## Odstavce Odstavce tvoří jeden nebo více řádků textu, oddělených jedním nebo více prázdnými řádky. ```md Toto je odstavec. Zde jsem napsal odstavec a je to bezva! Teď jsem v odstavci 2. A tady jsem pořád v odstavci 2! Ale tady už je odstavec 3. ``` Pokud byste chtěli vložit HTML element `<br />`, můžete na konec odstavce napsat dvě nebo více mezer a potom začít nový odstavec. ```md Tento odstavec končí dvěma mezerami. Nad tímto odstavcem je <br />! ``` ### Blokové citace Blokové citace se dělají jednoduše uvozením řádku znakem >. ```md > Toto je bloková citace. Můžete dokonce > manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky > jakkoli dlouhé, ať se zarovnají samy. > Je to jedno, pokud vždy začínají symbolem `>`. > Použít můžu i více než jednu úroveň >> odsazení. > Co vy na to? ``` ## Seznamy Nečíslovaný seznam můžete jednoduše udělat pomocí hvězdiček, plusů nebo pomlček: ```md * Položka * Položka * Jiná položka nebo + Položka + Položka + Další položka nebo - Položka - Položka - Další položka ``` Číslované seznamy se dělají pomocí číslice a `.`. ```md 1. Položka jedna 2. Položka dvě 3. Položka tři <!-- Čísla ani nemusíte psát popořadě. Markdown je umí zobrazit správně, jenom je třeba vždy překontrolovat, že číslování funguje správně. --> 1. Položka jedna 1. Položka dvě 1. Položka tři <!-- (Toto zobrazí to samé, jako příklad nad tím.) --> ``` Můžete také tvořit podseznamy: ```md 1. Položka jedna 2. Položka dvě 3. Položka tři - Podpoložka - Podpoložka 4. Položka čtyři ``` Vytvořit lze i zaškrtávací seznamy. Takto lze vytvořit seznam s HTML checkboxy. (Boxy níže bez 'x' jsou nezaškrtnuté checkboxy.) ```md - [ ] První úkol, který je třeba dokončit - [ ] Druhý úkol na dodělání Tento box bude zaškrtnutý - [x] Tento úkol byl dokončen ``` ## Bloky kódu Bloky kódu můžete označit tak, že řádek odsadíte čtyřmi mezerami nebo pomocí tabu. Pro interpretaci kódu parser používá `<code>` element. ```md Toto je kód Stejně jako toto ``` Pro ještě hlubší odsazení můžete přidat další 4 mezery nebo další tab: ```md moje_pole.each do |i| puts i end ``` Jednořádkový kód můžete zabalit do dvou zpětných apostrofů (`) tak, jako kdybyste text normálně stylovali: ```md Honza neměl tušení, co dělá funkce `go_to()`! ``` V Markdownu od GitHubu, můžete použít speciální syntaxi pro kód: ````md ```ruby def neco puts "Ahoj světe!" end ``` ```` Text výše nepotřebuje čtyřmezerové odsazení a parser navíc použije zvýraznění syntaxe pro zvolený jazyk. ## Vodorovná čára (`<hr />`) Vodorovnou oddělovací čáru lze snadno přidat pomocí 3 nebo více hvězdiček (nebo pomlček), a to buď s mezerami mezi jednotlivými znaky, nebo bez nich. ```md *** --- - - - **************** ``` ## Odkazy ```md <!-- Jedna z nejlepších vlastností Markdownu je, jak snadno lze s jeho pomocí vytvářet odkazy. Text odkazu, který chcete zobrazit vložte do [] a hned za něj v kulatých závorkách () připojte url adresu. --> [Klikni na mě!](http://test.com/) <!-- V uvozovkách za url můžete přidat název odkazu --> [Klikni na mě!](http://test.com/ "Odkaz na Test.com") <!-- Relativní cesty fungují také --> [Jdi na hudbu](/hudba/). <!-- Markdown taktéž podporuje referenční odkazy --> [Klikni na tento odkaz][link1] pro více informací! [Taky zkontrolujte tento odkaz][neco], jestli tedy chcete. [link1]: http://test.com/ "Cool!" [neco]: http://neco.czz/ "Dobře!" <!-- Titulek v tomto případě může být v jednoduchých uvozovkách, závorkách, nebo zcela vynechaný. Reference může být kdekoliv ve vašem dokumentu a identifikátory mohou být jakékoli, pokud jsou unikátní. --> <!-- V markdownu existuje rovněž "implicitní pojmenování", které použije text odkazu jako své id --> [Toto][] je odkaz.. [toto]: http://totojelink.cz/ <!-- Ale tento způsob se obvykle nepoužívá. --> ``` ### Obsahy Kombinace seznamů, odkazů a nadpisů využívají také některé parsery pro generování obsahu Markdown souborů. Jako identifikátory slouží jména nadpisů psané malými písmeny, které jsou uvozené křížkem (`#`). Víceslovné nadpisy bývají propojeny pomlčkou (`-`), která někdy nahrazuje i speciální znaky. Jiné speciální znaky mohou být vynechány. ```md - [Nadpis](#nadpis) - [Víceslovný text](#víceslovný-text) - [Odstavce](#odstavce) - [Podkapitola <h3 />](#podkapitola-h3-) ``` V případě obsahů se v každém případě jedná o nadstavbu, která nemusí všude fungovat stejně. ## Obrázky ```md <!-- Obrázky se vytváří stejně jako odkazy, ale s vykřičníkem na začátku --> ![Toto je atribut alt pro obrázek](http://imgur.com/myimage.jpg "Nepovinný titulek") <!-- Reference fungují tak, jak bychom čekali --> ![Toto je atribut alt][mujobrazek] [mujobrazek]: relativni/cesta/obrazek.jpg "a toto by byl titulek" ``` ## Ostatní ### Automatické odkazy ```md <http://stranka.cz/> je stejné jako [http://stranka.cz/](http://stranka.cz/) ``` ### Automatické odkazy z emailů ```md <jmeno@prijmeni.cz> ``` ### Escapování znaků ```md Chci napsat *tento text obklopený hvězdičkami*, ale protože nechci, aby to bylo kurzívou, tak hvězdičky vyescapuji `\`: \*tento text bude obklopený hvězdičkami\*. ``` ### Klávesové zkratky ```md <!-- V Markdownu od GitHubu můžete použít tag <kbd> k označení kláves na počítači --> Váš počítač přestal pracovat? Zkuste <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> ``` ### Tabulky Tabulky lze využít pouze v Markdownu od GitHubu a jejich syntax je trošku zvláštní. Kdybyste je chtěli použít, vytváří se takto: ```md | Sloupec1 | Sloupec2 | Sloupec3 | | :----------- | :------: | ------------: | | Vlevo zarovn.| Na střed | Vpravo zarovn.| | blah | blah | blah | <!-- nebo je jde taky zapsat takto: --> Sloupec 1 | Sloupec2 | Sloupec3 :-- | :-: | --: Že se to nedá číst? | No tak to takhle | radši nedělejte. ``` ## Markdownlint Pro usnadnění práce s Markdownem a s cílem sjednotit styl psaní jeho kódu vznikl nástroj `Markdownlint`. Tento nástroj je dostupný i jako plugin pro některé editory kódu (IDE) a lze jej použít jako nástroj pro vytváření a ověřování validity a čitelnosti Markdownu kódu. --- ## Reference Pro více informací doporučujeme oficiální článek o syntaxi od Johna Grubera [zde](http://daringfireball.net/projects/markdown/syntax) a skvělý tahák od Adama Pritcharda [zde](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). --- > _Pozn. překladatele:_ Tento text vznikl jako překlad původního článku, který > pochází z roku 2013 a kombinace původního českého překladu z roku 2015. > Některé informace v tomto článku, zejména ty, týkající se specifických > vlastností parserů markdownu tak již dnes mohou být zastaralé. Aktuální informace o specifických vlastnostech různých implementací Markdownu můžete nalézt zde (v angličtině): - [Markdown pro GitHub](https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) - [Markdown pro GitLab](https://docs.gitlab.com/ee/user/markdown.html)