> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/cs/clanky-do-hloubky/32-markdown-into-latex-with-style.md). # Markdown do LaTeXu se stylem **Aktualizace po zveřejnění** (13. května 2017): Jsme vděční Vítu Novotnému, autorovi/udržovateli `markdown` balíčku, za to, že nám napsal s užitečnou zpětnou vazbou ohledně původního článku. Jsme rádi, že můžeme zveřejnit tuto aktualizovanou verzi, která zohledňuje a zahrnuje jeho rady a návrhy. ### Úvod Před časem jsme se radovali z vydání [`balíčku markdown`](http://www.ctan.org/pkg/markdown) který umožnil psát syntaxi markdownu v dokumentech LaTeXu — a oslavili jsme to článkem s názvem [Jak psát v Markdownu na Overleafu](/latex/cs/clanky-do-hloubky/30-how-to-write-in-markdown-on-overleaf.md) jehož cílem bylo demonstrovat některé podporované syntaxe. **Pamatujte**: Budete muset kompilovat své `.tex` soubory s `--shell-escape` volbou, aby to fungovalo v lokálních instalacích LaTeXu — Overleaf to dělá za vás (automaticky). Mějte na paměti, že většina portálů pro odevzdávání do časopisů nepovoluje `--shell-escape`— pokud nesmíte nahrát pouze výsledné PDF svého rukopisu, vaše soubory LaTeXu obsahující markdown se při zpracování v systému pro odevzdávání nakladatele nemusí úspěšně zkompilovat. Jednou z myšlenek naznačených v [dřívějším článku](/latex/cs/clanky-do-hloubky/30-how-to-write-in-markdown-on-overleaf.md) je, že kombinace markdownu a LaTeXu umožňuje skvělé oddělení obsahu a stylu. Autoři (zejména ti, kteří už jsou s markdownem obeznámeni) by měli k dispozici mnohem stručnější syntaxi (s určitými výhradami), a přitom by stále měli přístup ke všem výhodám balíčků a šablon LaTeXu, které se postarají o styl a formátování. To [dřívějším článku](/latex/cs/clanky-do-hloubky/30-how-to-write-in-markdown-on-overleaf.md) uvedl několik příkladů použití markdownu v [prezentacích Beameru](https://www.overleaf.com/read/dnrwnjrpjjhw) a [posterech](https://www.overleaf.com/read/jtbgmmgqrqmh): dnes se podíváme na ještě zábavnější a vzrušující možnosti stylování! ### Použití markdownu ve stylovaných šablonách LaTeXu Mimo výše uvedené příklady můžete markdown použít téměř ve všech šablonách. Zde je několik rychlých příkladů: * Ta [Legrangeova oranžová kniha](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) šablonu * Ta [materiál inspirovaný Tufteem](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) šablonu * Tento [velmi pěkná šablona článku](https://www.overleaf.com/read/xfsrpsmdtqvt) od Thiaga Možná si všimnete, že dvě z nich jsou šablony článků a jedna je knižní šablona. [`balíčku markdown`](http://www.ctan.org/pkg/markdown) zjišťuje, zda `\chapter` je příkaz v daném dokumentu LaTeXu k dispozici a udělá nadpis první úrovně `markdown` řádek tak, aby se vykreslil jako `\chapter` nebo `\section` podle potřeby. ### Opravdu rychlé materiály: markdown + pocketmod Od chvíle, kdy jsem se poprvé dozvěděl o markdownu, mi připadal jako rychlý a pohodlný způsob, jak si dělat poznámky: odpovídá tomu, jak bych si mohl poznámky načmárat na útržky papíru nebo lístečky — zejména s odrážkovou a číslovanou syntaxí seznamů. Když jsem poprvé vytvořil [šablonu PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) v roce 2015, toužil jsem po způsobu, jak psát markdown v LaTeXu, abych mohl vytvářet PocketMody *s* markdown, protože to působilo… příhodně. Zapisování poznámek jednoduchou syntaxí do malých složených sešitků, ale s pěknou typografií — někteří lidé označují PocketMody jako „ziny“, protože jde o malé osmistránkové sešitky, které můžete vytvořit z jediného listu papíru A4. A skutečně to možné bylo! Díky tomu je poměrně snadné rychle vytvořit [minisešitek týdenního plánovače](https://www.overleaf.com/read/zfzcxygqwqsq) nebo malou [obrazovou knížku](https://www.overleaf.com/read/rppnsfgnrhsf). Ano, dceru bavilo vidět knížku pohádek vytvořenou z jejích vlastních kreseb… no, celých 10 minut! [`balíčku markdown`](http://www.ctan.org/pkg/markdown) umožňuje vám upravit, jak se každá syntaxe markdownu vykresluje do LaTeXu, takže jsem redefinoval standardní `![](img_file "popisek")` syntaxi tak, aby se popisek umístil pod obrázkový soubor (bez předpony „Figure“ nebo číslování), a pak jsem vložil zalomení stránky. Díky tomu je ještě snazší vytvořit obrázkovou knížku. Zde je video ukazující, jak se sešitek skládá: {% embed url="" %} ### Jednoduché kuchařské sešitky Když se nad tím zamyslíte, recept se skládá ze seznamů: seznamu surovin, seznamu přípravných nebo kuchařských pokynů a možná i seznamu poznámek (doba vaření, počet porcí atd.). Takže místo toho, abychom psali toto: ```latex \begin{enumerate} \item Nejprve udělejte toto \item Pak udělejte tamto ... \end{enumerate} ``` Určitě bych ocenil, kdybych mohl napsat toto: ``` #. Nejprve udělejte toto #. Pak udělejte tamto ``` A podobně i pro suroviny: ``` - 2 vejce - špetka soli ``` Takže pro snadné vytvoření rychlého receptu můžeme napsat toto: ``` # Míchaná vejce Doba vaření : 5 minut Porce : 1 ## Suroviny - 4 vejce - 1 lžička másla - 1/4 šálku mléka - sůl, pepř (dle chuti) ## Postup #. Rozšlehejte vejce, mléko... #. Na pánvi rozehřejte máslo... #. ... ``` Hmm, to vypadá slibně. Několik z nás v Overleafu (a naše rodiny) přispělo svými oblíbenými rychlými recepty (ideálními pro začínající kuchaře) a já jsem zbastlil (promiňte tu slovní hříčku) [šablonu rychlého receptu](https://www.overleaf.com/read/gscqdhnwzsfg) kterou můžete psát v markdownu *a* a udělat z ní minisešitek. [![A recipe booklet produced on Overleaf using markdown](/files/44f084323d7137b3e29750b382ffd381dc505b60)](https://www.overleaf.com/read/gscqdhnwzsfg) Nyní přichází další zábavná část. Uvnitř je to stále LaTeX, takže můžeme dál stylovat různé prvky — nadpisy sekcí, odrážkové seznamy, písma a tak dále — pomocí obvyklých triků LaTeXu. Tehdy jsem se už poněkud rozjel a přišel s *třemi* „tématy“ pro `simple-recipe` třídou! ### Bonus 1: Některá upozornění při používání balíčku markdown * SyncTeX nebude úplně fungovat. V Overleafu to znamená, že operace „pozice v náhledu“ a „kliknutí v náhledu pro skok ke zdroji“ nebudou fungovat v `markdown` oblastech. * `\\` ztrácí svůj obvyklý význam: obvyklé „dvě mezery následované novým řádkem“ `markdown` trik zde nefunguje, protože koncové mezery budou odstraněny parserem Lua, jak je popsáno v [`markdown` dokumentace balíčku](http://texdoc.net/pkg/markdown). `\newline` bude však fungovat. * Pozor na více znaků podtržítka na stejném řádku — to může být problém, pokud: * pracujete s mnoha dolními indexy ve svých rovnicích (tip: v takových případech vystupte z `markdown` prostředí); * rádi používáte podtržítka ve svých klíčích BibTeXu. Můžete nastavit `underscores=false` s nejnovějšími `balíčku markdown` soubory, aby fungovala podtržítka pro dolní indexy, ale stále to nebude fungovat s podtržítky v klíčích BibTeXu. **Aktualizace** (13. května 2017): Podtržítka v klíčích BibTeXu budou fungovat s `markdown` verzí v2.5.2 a novějšími — díky, Víte! * Budete mít určité potíže se zobrazením doslovného znaku #, protože ani `\#` nebude fungovat! Obvykle si definuji nový příkaz a používám ten místo toho. ### Bonus 2: Nové funkce v aktualizovaném balíčku markdown `markdown` verze v2.4 a novější přidaly podporu pro některé opravdu pěkné syntaxe: * **Syntaxe vložené poznámky pod čarou**: `...^[to je poznámka pod čarou]` (vyžaduje `inlineFootnotes` volbu) * **Citace:**`[@smith1990]` (vyžaduje `citací` volbu; také si dejte pozor na podtržítka ve svých klíčích BibTeXu!) * **Kód v bloku**: Můžete použít buď vlnovky `~` nebo zpětné apostrofy `` ` `` jako ohraničení. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Pokud chcete tyto nové funkce používat, nezapomeňte nahrát aktualizované verze `markdown.lua`, `markdown.tex` a `markdown.sty` do svého projektu — nebo si můžete jednoduše vytvořit nový projekt z [této šablony](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/cs/clanky-do-hloubky/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.