Tahák Markdownu

Agenda není markdownový editor, ale některou syntaxi Markdownu rozpoznává a používá ji k aplikaci stylů. Zde jsou markdownové zkratky, které lze použít.

Styly odstavců

Následující styly mění vzhled celého odstavce.

Nadpis

Na začátek řádku napište 1–6 křížků a za ně mezeru. Úroveň nadpisu určuje počet křížků. Např. ### Ukázka vytvoří nadpis třetí úrovně.

Odrážkový seznam

Začněte řádek odrážkou, spojovníkem, hvězdičkou nebo znaménkem plus a vytvoříte položku odrážkového seznamu. Např. • Ukázková položka 1 - Ukázková položka 2 * Ukázková položka 3 + Ukázková položka 4 vytvoří položku odrážkového seznamu.

Číslovaný seznam

Začněte řádek číslem následovaným tečkou a mezerou a vytvoříte položku číslovaného seznamu. Např. \1. Ukázková položka 1 vytvoří položku číslovaného seznamu.

Chcete-li číslovaný seznam začít jiným číslem než 1, jednoduše použijte to číslo Např. \3. Ukázková položka 3 vytvoří položku číslovaného seznamu začínající číslem 3.

Kontrolní seznam

Začněte řádek spojovníkem, za nímž následuje otevírací a zavírací hranatá závorka. Vložením „x“ mezi obě závorky vytvoříte zaškrtnutou položku. Např. - [ ] Ukázka vytvoří položku kontrolního seznamu.

- [x] Ukázka vytvoří zaškrtnutou položku.

Spojovník je volitelný, takže zaškrtávací políčko můžete vytvořit i pouhými dvěma hranatými závorkami.

Předformátovaný

Na obsah, kterému nejvíc sluší písmo s pevnou šířkou, například počítačový kód, můžete použít předformátovaný styl. Tento styl vyvoláte tak, že řádek začnete třemi zpětnými apostrofy. Např. ```ukázka vytvoří ukázka

Kód

Agenda podporuje barevné zvýrazňování syntaxe počítačového kódu. Přidáním názvu jazyka za tři zpětné apostrofy určíte, v jakém jazyce je úryvek kódu napsán. Např. ```swift int i = 0; vytvoří int i = 0 obarvené podle jazyka Swift

Kompletní seznam všech podporovaných jazykových parametrů udržuje projekt highlight.js na adrese https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Bloková citace

Na začátek řádku napište jeden nebo více znaků > a za ně mezeru. Počet znaků > určuje úroveň citace, kterou naznačují svislé čáry před textem. Např. > Ukázka vytvoří

Ukázka

Styly do řádku

Tyto styly se používají uvnitř odstavců ke změně vzhledu textu.

Kurzíva

Uzavření do podtržítek nebo hvězdiček vytvoří kurzívu. Např. _ukázka_ nebo *ukázka* vytvoří ukázka

Tučné písmo

Uzavření do dvojitých podtržítek nebo dvojitých hvězdiček vytvoří tučné písmo. Např. __ukázka__ nebo **ukázka** vytvoří ukázka

Přeškrtnuté

Uzavření do dvojitých vlnovek vytvoří přeškrtnutý text. Např. ~~ukázka~~ vytvoří ukázka

Pevná šířka (neproporcionální)

U některého obsahu, například zdrojového kódu, je vhodnější text s pevnou šířkou. U bloků textu je nejlepší použít styl odstavce Předformátovaný. U textu v řádku jej můžete uzavřít do zpětných apostrofů. Např. `ukázka` vytvoří ukázka

Zvýraznit

Uzavření do dvojitých rovnítek nebo dvojteček vytvoří zvýraznění. Např. ==ukázka== nebo ::ukázka:: zvýrazní slovo ukázka

Vložit

Některé styly nesouvisejí s významem textu, ale slouží k vymezení informačních prvků, jako jsou štítky. I ty lze zadávat pomocí syntaxe podobné Markdownu.

Štítky

Štítek zadáte jednoduše pomocí znaku #, za nímž následuje název štítku. Štítek nesmí obsahovat mezery. Např. Napište #giraffes a vytvoříte štítek s názvem „giraffes“.

Napsání znaku # vyvolá vyskakovací okno automatického doplňování, které vám pomůže najít hledaný štítek.

Štítky mohou obsahovat také parametr v závorkách. Například #due(12/12/2018). Chcete-li se dozvědět více o tom, jak parametry ve štítcích plně využít, přečtěte si kapitolu Štítky, lidé, textové akce a odkazy.

Štítky osob

Agenda rozpoznává druhý typ štítků vyhrazený pro jednotlivce (osoby). Můžete zadat jméno nebo iniciály a odkázat tak na přítele či kolegu. Stačí před text napsat znak @. Např. Zadáním @Tom vytvoříte štítek osoby pro někoho jménem „Tom“.

Napsání znaku @ vyvolá vyskakovací okno automatického doplňování, které vám pomůže najít hledanou osobu.

Emodži

Emodži zadáte tak, že napíšete : (dvojtečku), za ni zkratku emodži a na konec opět :. Např. Napište :+1: a vložíte emodži 👍.

Napsání znaku : vyvolá vyskakovací okno automatického doplňování, které vám pomůže najít hledané emodži.

Horizontální čára

Pokud chcete v poznámkách vizuálně oddělit jednotlivé části horizontální čárou (vodorovnou linkou), stačí napsat tři pomlčky za sebou a mezeru: Např. Zadáním --- vytvoříte horizontální čáru.

Tip: Pokud markdownový soubor importujete, můžete jej pomocí týchž tří pomlček za sebou nechat rozdělit na jednotlivé poznámky v Agendě: Např. První poznámka --- Druhá poznámka

Tím vzniknou dvě různé poznámky, první s obsahem „První poznámka“ a druhá s obsahem „Druhá poznámka“.

Tabulky

Agenda umožňuje vkládat do poznámek tabulky, které rychle vytvoříte napsáním tří či více svislítek (|) za sebou na začátku řádku: Např. Zadáním ||| vložíte tabulku.

Odkazy

Odkazy se v textu rozpoznávají automaticky, ale můžete je přidat i pomocí syntaxe Markdownu. Do hranatých závorek uzavřete zobrazovaný text a za ně do kulatých závorek adresu URL odkazu. Např. Zadáním [Agenda](agenda.com) vytvoříte odkaz na agenda.com připojený k textu „Agenda“.

Textové akce

Ačkoli to není striktně vzato součást klasické syntaxe Markdownu, Agenda umožňuje spouštět určité akce, pokud začnete napsáním zpětného lomítka \ a za ním akce.

Například \remind vyvolá vložení připomínky do vaší poznámky. Jako součást akce lze uvést volitelné parametry – například \remind(today at noon) naplánuje připomínku na dnešek na poledne. Dalšími běžnými akcemi jsou \now, \date a \time pro vložení aktuálního data a času.

Kompletní přehled všech akcí najdete v kapitole Tahák textových akcí.

Akce lze používat také jako zástupné symboly v šablonách – viz kapitola Vytváření a používání šablon.

Jak zabránit zpracování Markdownu

Přestože jsou markdownové zkratky nesmírně užitečné a rychlé, občas nastane situace, kdy nechcete, aby se něco jako Markdown rozpoznalo. Výše uvedené markdownové sekvence můžete odescapovat tak, že nejprve napíšete znak zpětného lomítka \ a za ním to, co byste normálně napsali. Po stisku mezerníku by zpětné lomítko mělo automaticky zmizet a text by měl zůstat tak, jak jste jej napsali. Například napsáním \1. Něco nevznikne číslovaný seznam, ale text 1. Něco.

Mějte na paměti, že uvnitř textu se stylem odstavce Předformátovaný a stylem do řádku Pevná šířka se Markdown nikdy nezpracovává.