Ściągawka Markdown

Agenda nie jest edytorem markdown, ale rozpoznaje część składni markdown do stosowania stylów. Oto skróty markdown, których możesz używać.

Style akapitowe

Poniższe style zmieniają wygląd całego akapitu.

Nagłówek

Użyj od 1 do 6 znaków hash na początku wiersza, po nich spacja. Poziom nagłówka wyznacza liczba znaków hash. Np. ### Przykład tworzy nagłówek trzeciego poziomu.

Lista wypunktowana

Rozpocznij wiersz od punktora, myślnika, gwiazdki lub znaku plus, aby utworzyć pozycję listy wypunktowanej. Np. • Przykładowa pozycja 1 - Przykładowa pozycja 2 * Przykładowa pozycja 3 + Przykładowa pozycja 4 tworzy pozycję listy z myślnikiem lub punktorem.

Lista numerowana

Rozpocznij wiersz od liczby, po której następuje kropka i spacja, aby utworzyć pozycję listy numerowanej. Np. \1. Przykładowa pozycja 1 tworzy pozycję listy numerowanej.

Aby rozpocząć listę numerowaną od liczby innej niż 1, po prostu użyj tej liczby Np. \3. Przykładowa pozycja 3 tworzy pozycję listy numerowanej zaczynającej się od 3.

Lista kontrolna

Rozpocznij wiersz od myślnika, po którym następuje otwierający i zamykający nawias kwadratowy. Wstawienie „x” między nawiasami tworzy pozycję zaznaczoną. Np. - [ ] Przykład tworzy pozycję listy kontrolnej.

- [x] Przykład tworzy pozycję zaznaczoną.

Myślnik jest opcjonalny, więc pole wyboru możesz utworzyć również przy użyciu samych dwóch nawiasów kwadratowych.

Uprzednio sformatowany

W przypadku treści, które najlepiej wyglądają w czcionce o stałej szerokości, takich jak kod komputerowy, możesz zastosować styl uprzednio sformatowany. Styl ten wywołasz, zaczynając wiersz od trzech znaków wstecznego apostrofu. Np. ```przykład tworzy przykład

Kod

Agenda obsługuje kolorowanie składni kodu komputerowego. Dodając nazwę języka po trzech znakach wstecznego apostrofu, możesz wskazać, w jakim języku został napisany fragment kodu. Np. ```swift int i = 0; tworzy int i = 0 pokolorowane przy użyciu języka Swift

Kompletną listę wszystkich obsługiwanych parametrów językowych prowadzi projekt highlight.js pod adresem https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Blok cytatu

Użyj jednego lub więcej znaków > na początku wiersza, po nich spacja. Liczba znaków > określa poziom cytatu, wskazywany pionowymi liniami poprzedzającymi tekst. Np. > Przykład tworzy

Przykład

Style w tekście

Tych stylów używa się wewnątrz akapitów do zmiany wyglądu tekstu.

Kursywa

Ujęcie w znaki podkreślenia lub gwiazdki daje styl kursywy. Np. _przykład_ lub *przykład* tworzy przykład

Pogrubiony

Ujęcie w podwójne znaki podkreślenia lub podwójne gwiazdki daje styl pogrubiony. Np. __przykład__ lub **przykład** tworzy przykład

Przekreślenie

Ujęcie w podwójne tyldy daje styl przekreślenia. Np. ~~przykład~~ tworzy przykład

Stała szerokość (czcionka o stałej szerokości)

W przypadku niektórych treści, takich jak kod źródłowy programów, lepszy jest tekst o stałej szerokości. Dla bloków tekstu najlepiej użyć stylu akapitowego Uprzednio sformatowany. Dla tekstu w wierszu możesz ująć go we wsteczne apostrofy. Np. `przykład` tworzy przykład

Wyróżnienie

Ujęcie w podwójne znaki równości lub dwukropki daje styl wyróżnienia. Np. ==przykład== lub ::przykład:: wyróżnia słowo przykład

Wstaw

Niektóre style nie odnoszą się do znaczenia tekstu, lecz służą do wyodrębnienia elementów informacyjnych, takich jak tagi. Można je również wprowadzać przy użyciu składni podobnej do markdown.

Tagi

Aby wprowadzić tag, użyj po prostu symbolu #, a po nim nazwy tagu. Tag nie może zawierać spacji. Np. Wpisz #giraffes, aby utworzyć tag o nazwie „giraffes”.

Wpisanie znaku # wywoła okienko autouzupełniania, które pomoże Ci znaleźć szukany tag.

Tagi mogą też zawierać parametr w nawiasach. Na przykład #due(12/12/2018). Aby dowiedzieć się więcej o pełnym wykorzystaniu parametrów w tagach, zobacz rozdział Tagi, osoby, akcje tekstowe i linki.

Tagi osób

Agenda rozpoznaje drugi rodzaj tagów, zarezerwowany dla osób. Możesz wpisać imię lub inicjały, aby odwołać się do znajomego lub współpracownika. Wystarczy wstawić przed tekstem symbol @. Np. Wpisz @Tom, aby utworzyć tag osoby dla kogoś o imieniu „Tom”.

Wpisanie znaku @ wywoła okienko autouzupełniania, które pomoże Ci znaleźć szukaną osobę.

Emoji

Aby wstawić emoji, wpisz po prostu : (dwukropek), następnie skrótową nazwę emoji, a na końcu ponownie :. Np. Wpisz :+1:, aby wstawić emoji 👍.

Wpisanie znaku : wywoła okienko autouzupełniania, które pomoże Ci znaleźć szukane emoji.

Pozioma linia

Jeśli chcesz wizualnie rozdzielać sekcje w swoich notatkach za pomocą poziomej linii, możesz to zrobić, wpisując trzy myślniki z rzędu, a po nich spację: Np. Wpisz ---, aby utworzyć poziomą linię.

Wskazówka: Jeśli importujesz plik markdown, możesz go podzielić na osobne notatki w Agendzie, używając tych samych trzech myślników z rzędu: Np. Pierwsza notatka --- Druga notatka

Utworzy to dwie różne notatki: pierwszą o treści „Pierwsza notatka” i drugą o treści „Druga notatka”.

Tabele

Agenda daje Ci możliwość wstawiania tabel do notatek, które możesz szybko utworzyć, wpisując trzy lub więcej znaków kreski pionowej (|) z rzędu na początku wiersza: Np. Wpisz |||, aby wstawić tabelę.

Linki

Linki są rozpoznawane w tekście automatycznie, ale możesz je również dodawać składnią markdown. Użyj nawiasów kwadratowych, aby ująć wyświetlany tekst, a po nich nawiasów zwykłych zawierających adres URL linku. Np. Wpisz [Agenda](agenda.com), aby utworzyć link do agenda.com dołączony do tekstu „Agenda”.

Akcje tekstowe

Choć nie należą one ściśle do klasycznej składni markdown, Agenda pozwala wywoływać określone akcje, jeśli zaczniesz od wpisania znaku ukośnika wstecznego , a po nim nazwy akcji.

Na przykład \remind wywoła wstawienie przypomnienia do Twojej notatki. W ramach akcji można podać opcjonalne parametry, na przykład \remind(today at noon) zaplanuje przypomnienie na dziś w południe. Inne częste akcje to \now, \date i \time, służące do wstawiania bieżącej daty i godziny.

Pełny przegląd wszystkich akcji znajdziesz w rozdziale Ściągawka akcji tekstowych.

Akcji można też używać jako symboli zastępczych w szablonach, zobacz rozdział Tworzenie i używanie szablonów.

Zapobieganie przetwarzaniu markdown

Choć skróty markdown potrafią być bardzo przydatne i szybkie, bywają sytuacje, w których nie chcesz, aby coś zostało rozpoznane jako markdown. Powyższe sekwencje markdown możesz zabezpieczyć, wpisując najpierw znak ukośnika wstecznego \, a po nim to, co normalnie byś wpisał. Po naciśnięciu spacji ukośnik wsteczny powinien automatycznie zniknąć, a tekst pozostać taki, jak go wpisałeś. Na przykład wpisanie \1. Coś nie utworzy listy numerowanej, lecz tekst 1. Coś.

Pamiętaj, że markdown nigdy nie jest przetwarzany wewnątrz tekstu, który ma styl akapitowy Uprzednio sformatowany i styl w tekście Stała szerokość.