--- 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 (`
` 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.
---
> _Pozn. překladatele:_ Tento text vznikl jako překlad původního článku, který
> vznikl v roce 2013, který byl po obsahové stránce naposledy editován v roce
> 2015 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 vlastnostní parserů
> markdownu tak již dnes mohou být zasrtaralé.
>
> Za účelem aktualizace tohoto článku jsem přidal kapitoly o
> [generování obsahů](#obsahy), které mj. využívá i tento článek a o
> [Markdownlintu](#markdownlint).
---
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).