Ťahák pre Markdown

Agenda nie je markdownový editor, no niektorú syntax markdownu rozpoznáva na použitie štýlov. Tu sú markdownové skratky, ktoré môžete použiť.

Štýly odsekov

Nasledujúce štýly menia vzhľad celého odseku.

Nadpis

Na začiatku riadka použite 1 až 6 znakov mriežky, za ktorými nasleduje medzera. Úroveň nadpisu určuje počet mriežok. Napr. ### Ukážka vytvorí nadpis tretej úrovne.

Odrážkový zoznam

Ak chcete vytvoriť položku odrážkového zoznamu, začnite riadok odrážkou, spojovníkom, hviezdičkou alebo znamienkom plus. Napr. • Ukážková položka 1 - Ukážková položka 2 * Ukážková položka 3 + Ukážková položka 4 vytvorí položku odrážkového zoznamu.

Číslovaný zoznam

Ak chcete vytvoriť položku číslovaného zoznamu, začnite riadok číslom, za ktorým nasleduje bodka a medzera. Napr. \1. Ukážková položka 1 vytvorí položku číslovaného zoznamu.

Ak chcete číslovaný zoznam začať iným číslom než 1, jednoducho použite dané číslo Napr. \3. Ukážková položka 3 vytvorí položku číslovaného zoznamu začínajúcu číslom 3.

Kontrolný zoznam

Začnite riadok spojovníkom, za ktorým nasleduje otváracia a zatváracia hranatá zátvorka. Vložením písmena „x“ medzi obe zátvorky vytvoríte označenú položku. Napr. - [ ] Ukážka vytvorí položku kontrolného zoznamu.

- [x] Ukážka vytvorí označenú položku.

Spojovník je voliteľný, takže zaškrtávacie políčko môžete vytvoriť aj len pomocou dvoch hranatých zátvoriek.

Predformátované

Pri obsahu, ktorému najlepšie svedčí písmo s pevnou šírkou, napríklad pri počítačovom kóde, môžete použiť štýl predformátované. Tento štýl vyvoláte tak, že riadok začnete tromi spätnými apostrofmi. Napr. ```ukážka vytvorí ukážka

Kód

Agenda podporuje farebné zvýrazňovanie syntaxe počítačového kódu. Pridaním názvu jazyka za tri spätné apostrofy naznačíte, v akom jazyku je úryvok kódu napísaný. Napr. ```swift int i = 0; vytvorí int i = 0 zafarbené podľa jazyka Swift

Úplný zoznam všetkých podporovaných parametrov jazykov spravuje projekt highlight.js na adrese https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Citácia

Na začiatku riadka použite jeden alebo viac znakov >, za ktorými nasleduje medzera. Počet znakov > určuje úroveň citácie, ktorú vyznačujú zvislé čiary pred textom. Napr. > Ukážka vytvorí

Ukážka

Štýly do riadku

Tieto štýly sa používajú vnútri odsekov na zmenu vzhľadu textu.

Kurzíva

Uzavretie do podčiarkovníkov alebo hviezdičiek vytvorí kurzívu. Napr. _ukážka_ alebo *ukážka* vytvorí ukážka

Tučné písmo

Uzavretie do dvojitých podčiarkovníkov alebo dvojitých hviezdičiek vytvorí tučné písmo. Napr. __ukážka__ alebo **ukážka** vytvorí ukážka

Prečiarknuté

Uzavretie do dvojitých vlnoviek vytvorí prečiarknuté písmo. Napr. ~~ukážka~~ vytvorí ukážka

Pevná šírka (neproporcionálne)

Pri niektorom obsahu, napríklad pri zdrojovom počítačovom kóde, je vhodnejší text s pevnou šírkou. Pri blokoch textu je najlepšie použiť štýl odseku Predformátované. Pri texte v riadku ho môžete uzavrieť do spätných apostrofov. Napr. `ukážka` vytvorí ukážka

Zvýrazniť

Uzavretie do dvojitých znamienok rovnosti alebo dvojbodiek vytvorí zvýraznenie. Napr. ==ukážka== alebo ::ukážka:: zvýrazní slovo ukážka

Vložiť

Niektoré štýly nesúvisia s významom textu, ale používajú sa na vymedzenie informačných prvkov, ako sú tagy. Aj tie sa dajú zadať pomocou syntaxe podobnej markdownu.

Tagy

Ak chcete zadať tag, jednoducho použite znak # a za ním tag. Tag nemôže obsahovať medzery. Napr. Napíšte #giraffes a vytvoríte tag s názvom „giraffes“.

Napísanie znaku # vyvolá vyskakovacie okno s automatickým dopĺňaním, ktoré vám pomôže nájsť hľadaný tag.

Tagy môžu obsahovať aj parameter v okrúhlych zátvorkách, napríklad #due(12/12/2018). Ak sa chcete dozvedieť viac o tom, ako parametre v tagoch naplno využiť, pozrite si kapitolu Tagy, ľudia, textové akcie a odkazy.

Tagy osôb

Agenda rozpoznáva druhý typ tagu vyhradený pre jednotlivcov (osoby). Zadaním mena alebo iniciálok môžete odkázať na priateľa či kolegu. Stačí pred text zadať znak @. Napr. Zadajte @Tom a vytvoríte tag osoby pre niekoho s menom „Tom“.

Napísanie znaku @ vyvolá vyskakovacie okno s automatickým dopĺňaním, ktoré vám pomôže nájsť hľadanú osobu.

Emodži

Ak chcete zadať emodži, jednoducho napíšte : (znak dvojbodky), za ním skratku emodži a nakoniec znova zatváraciu :. Napr. Napíšte :+1: a vložíte emodži 👍.

Napísanie znaku : vyvolá vyskakovacie okno s automatickým dopĺňaním, ktoré vám pomôže nájsť hľadané emodži.

Vodorovná čiara

Ak chcete časti svojich poznámok vizuálne oddeliť vodorovnou čiarou, môžete to urobiť napísaním troch pomlčiek za sebou, za ktorými nasleduje medzera: Napr. Zadajte --- a vytvoríte vodorovnú čiaru.

Tip: Ak importujete markdownový súbor, môžete ho v Agende dať rozdeliť na jednotlivé poznámky pomocou tých istých troch pomlčiek za sebou: Napr. Prvá poznámka --- Druhá poznámka

Takto vzniknú dve rôzne poznámky, prvá s obsahom „Prvá poznámka“ a druhá s obsahom „Druhá poznámka“.

Tabuľky

Agenda vám umožňuje vkladať do poznámok tabuľky, ktoré rýchlo vytvoríte napísaním troch alebo viacerých zvislých čiar (|) za sebou na začiatku riadka: Napr. Zadajte ||| a vložíte tabuľku.

Odkazy

Odkazy sa v texte rozpoznávajú automaticky, no môžete ich pridať aj pomocou syntaxe markdownu. Do hranatých zátvoriek uzavrite text, ktorý sa zobrazí, a za ne do okrúhlych zátvoriek adresu URL odkazu. Napr. Zadajte [Agenda](agenda.com) a vytvoríte odkaz na agenda.com pripojený k textu „Agenda“.

Textové akcie

Hoci to nie je striktne súčasť klasickej syntaxe markdownu, Agenda umožňuje spúšťať určité akcie, ak začnete napísaním znaku spätnej lomky \ a za ním akcie.

Napríklad \remind vyvolá vloženie pripomienky do vašej poznámky. Ako súčasť akcie možno uviesť voliteľné parametre, napríklad \remind(today at noon) naplánuje pripomienku na dnes na poludnie. Ďalšie bežné akcie sú \now, \date a \time na vloženie aktuálneho dátumu a času.

Úplný prehľad všetkých akcií nájdete v kapitole Ťahák pre textové akcie.

Akcie sa dajú použiť aj ako zástupné symboly v šablónach, pozrite si kapitolu Vytváranie a používanie šablón.

Zabránenie spracovaniu markdownu

Hoci markdownové skratky môžu byť mimoriadne užitočné a rýchle, niekedy nechcete, aby sa niečo rozpoznalo ako markdown. Vyššie uvedené markdownové sekvencie môžete escapovať tak, že najprv napíšete znak spätnej lomky \ a za ním to, čo by ste normálne napísali. Po stlačení medzerníka by mal znak spätnej lomky automaticky zmiznúť a text by mal zostať tak, ako ste ho napísali. Napríklad napísaním \1. Niečo nevznikne číslovaný zoznam, ale text 1. Niečo.

Nezabudnite, že markdown sa nikdy nespracúva vnútri textu, ktorý má štýl odseku Predformátované a štýl do riadku Pevná šírka.