--- language: markdown lang: cs-cz contributors: - ["Dan Turkel", "http://danturkel.com/"] translators: - ["Michal Martinek", "https://github.com/MichalMartinek"] - ["Tomáš Hartman", "https://github.com/tomas-hartman"] filename: markdown-cz.md lang: cs-cz --- 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. ## Obsah - [Obsah](#obsah) - [HTML Elementy](#html-elementy) - [Nadpisy](#nadpisy) - [Jednoduché stylování textu](#jednoduché-stylování-textu) - [Odstavce](#odstavce) - [Blokové citace](#blokové-citace) - [Seznamy](#seznamy) - [Bloky kódu](#bloky-kódu) - [Vodorovná čára (`
`)](#vodorovná-čára-hr-) - [Odkazy](#odkazy) - [Obsahy](#obsahy) - [Obrázky](#obrázky) - [Ostatní](#ostatní) - [Automatické odkazy](#automatické-odkazy) - [Automatické odkazy z emailů](#automatické-odkazy-z-emailů) - [Escapování znaků](#escapování-znaků) - [Klávesové zkratky](#klávesové-zkratky) - [Tabulky](#tabulky) - [Markdownlint](#markdownlint) - [Reference](#reference) ## HTML Elementy Markdown je nadstavba HTML. To znamená, že každý HTML kód je zároveň validním kódem v Markdownu. ```md ``` ## Nadpisy HTML elementy `

` až `

` vytvoříte jednoduše tak, že nadpisu předsadíte takový počet křížků (#), jaký odpovídá úrovni nadpisu. ```md # Toto je

## Toto je

### Toto je

#### Toto je

##### Toto je

###### Toto je
``` 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 `
`, 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
! ``` ### 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 1. Položka jedna 1. Položka dvě 1. Položka tři ``` 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á `` 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:
```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 (`
`) 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 [Klikni na mě!](http://test.com/) [Klikni na mě!](http://test.com/ "Odkaz na Test.com") [Jdi na hudbu](/hudba/). [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!" [Toto][] je odkaz.. [toto]: http://totojelink.cz/ ``` ### 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

](#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 ![Toto je atribut alt pro obrázek](http://imgur.com/myimage.jpg "Nepovinný titulek") ![Toto je atribut alt][mujobrazek] [mujobrazek]: relativni/cesta/obrazek.jpg "a toto by byl titulek" ``` ## Ostatní ### Automatické odkazy ```md je stejné jako [http://stranka.cz/](http://stranka.cz/) ``` ### Automatické odkazy z emailů ```md ``` ### 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áš počítač přestal pracovat? Zkuste Ctrl+Alt+Del ``` ### 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 | 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)