Markdown — snydeark
Agenda er ikke en markdown-editor, men den genkender noget markdown-syntaks til at anvende stilarter. Her er de markdown-genveje, du kan bruge.
Afsnitsstile
De følgende stilarter ændrer udseendet af hele afsnittet.
Overskrift
Brug 1-6 havelågesymboler i begyndelsen af linjen efterfulgt af et mellemrum. Overskriftsniveauet bestemmes af antallet af havelåger. F.eks. ### Eksempel giver en overskrift på tredje niveau.
Stiplet liste eller punktliste
Begynd en linje med et punkttegn, en bindestreg, en stjerne eller et plustegn for at lave et emne i en stiplet liste. F.eks. • Eksempelemne 1 - Eksempelemne 2 * Eksempelemne 3 + Eksempelemne 4 giver et emne i en stiplet liste eller punktliste.
Nummereret liste
Begynd en linje med et tal efterfulgt af et punktum og et mellemrum for at lave et emne i en nummereret liste. F.eks. \1. Eksempelemne 1 giver et emne i en nummereret liste.
Vil du starte en nummereret liste fra et andet tal end 1, skal du blot bruge det tal F.eks. \3. Eksempelemne 3 giver et emne i en nummereret liste, der starter ved 3.
Tjekliste
Begynd en linje med en bindestreg efterfulgt af en venstre og en højre kantet parentes. Indsætter du et “x” mellem de to parenteser, får du et markeret emne. F.eks. - [ ] Eksempel giver et emne i en tjekliste.
- [x] Eksempel giver et markeret emne.
Bindestregen er valgfri, så du kan også lave et afkrydsningsfelt med blot to kantede parenteser.
Forudformateret
Til indhold, der fungerer bedst med en skrift med fast bredde, som computerkode, kan du anvende den forudformaterede stil. Du udløser denne stil ved at starte linjen med tre backticks.
F.eks.
```eksempel giver eksempel
Kode
Agenda understøtter syntaksfarvning af computerkode. Ved at tilføje sproget efter de tre backticks kan du angive, hvilket sprog kodestumpen er skrevet i.
F.eks.
```swift int i = 0; giver int i = 0 farvet ud fra sproget Swift
En komplet liste over alle understøttede sprogparametre vedligeholdes af highlight.js-projektet på https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.
Blokcitat
Brug et eller flere >-symboler i begyndelsen af linjen efterfulgt af et mellemrum. Antallet af >-tegn bestemmer citatniveauet, som vises med de lodrette streger før teksten.
F.eks.
> Eksempel giver
Eksempel
Indlejrede stilarter
Disse stilarter bruges inde i afsnit til at ændre tekstens udseende.
Kursiv
Omslutning med understregningstegn eller stjerner giver kursiv formatering. F.eks. _eksempel_ eller *eksempel* giver eksempel
Fed
Omslutning med dobbelte understregningstegn eller dobbelte stjerner giver fed formatering. F.eks. __eksempel__ eller **eksempel** giver eksempel
Gennemstreget
Omslutning med dobbelte tildetegn giver gennemstreget formatering.
F.eks.
~~eksempel~~ giver eksempel
Fast bredde (monospatieret)
For noget indhold, som computerkildekode, er det at foretrække at have tekst med fast bredde. Til tekstblokke er det bedst at bruge afsnitsstilen Forudformateret. Til indlejret tekst kan du omslutte med backticks.
F.eks.
`eksempel` giver eksempel
Fremhæv
Omslutning med dobbelte lighedstegn eller koloner giver fremhævet formatering. F.eks. ==eksempel== eller ::eksempel:: fremhæver ordet eksempel
Indsæt
Nogle stilarter er ikke knyttet til tekstens betydning, men bruges til at afgrænse informationselementer som tags. De kan også indtastes med markdown-lignende syntaks.
Tags
For at indtaste et tag skal du blot bruge et #-symbol efterfulgt af tagget. Tagget må ikke indeholde mellemrum.
F.eks.
Skriv #giraffes for at oprette et tag ved navn “giraffes”.
Skriver du et #, udløses popoveren til autofuldførelse, som hjælper dig med at finde det tag, du leder efter.
Tags kan også indeholde en parameter i parenteser. For eksempel #due(12/12/2018). Se kapitlet Tags, personer, teksthandlinger og links for at lære mere om, hvordan du får fuldt udbytte af parametre i tags.
Persontags
Agenda genkender en anden type tag, der er forbeholdt enkeltpersoner (personer). Du kan skrive et navn eller initialer for at henvise til en ven eller kollega. Skriv blot et @-symbol foran teksten.
F.eks.
Skriv @Tom for at oprette et persontag til en person ved navn “Tom”.
Skriver du et @, udløses popoveren til autofuldførelse, som hjælper dig med at finde den person, du leder efter.
Emoji
For at indsætte en emoji skal du blot skrive et : (kolontegn) efterfulgt af emojiens kortnavn og et afsluttende : igen.
F.eks.
Skriv :+1: for at indsætte emojien 👍.
Skriver du et :, udløses popoveren til autofuldførelse, som hjælper dig med at finde den emoji, du leder efter.
Vandret streg
Vil du visuelt afgrænse afsnit i dine noter med en vandret streg (en vandret linje), kan du gøre det ved at skrive tre bindestreger i træk efterfulgt af et mellemrum:
F.eks.
Skriv --- for at oprette en vandret streg.
Tip: Hvis du importerer en markdown-fil, kan du få den opdelt i enkelte noter i Agenda med de samme tre bindestreger i træk: F.eks. Første note
---Anden noteDet vil oprette to forskellige noter, den første med indholdet “Første note” og den anden med indholdet “Anden note”.
Tabeller
Agenda giver dig mulighed for at indsætte tabeller i dine noter, som du hurtigt kan oprette ved at skrive tre eller flere lodrette streger (|) i træk i begyndelsen af linjen:
F.eks.
Skriv ||| for at indsætte en tabel.
Links
Links genkendes automatisk i tekst, men du kan også tilføje dem med markdown-syntaks. Brug kantede parenteser til at omslutte den tekst, der vises, efterfulgt af almindelige parenteser omkring linkets URL. F.eks. Skriv [Agenda](agenda.com) for at oprette et link til agenda.com knyttet til teksten “Agenda”.
Teksthandlinger
Selvom det ikke strengt taget er en del af klassisk markdown-syntaks, giver Agenda dig mulighed for at udløse bestemte handlinger, hvis du begynder med at skrive et omvendt skråstregssymbol \ efterfulgt af en handling.
For eksempel vil \remind udløse indsættelse af en påmindelse i din note. Valgfrie parametre kan angives som en del af handlingen; for eksempel vil \remind(today at noon) planlægge en påmindelse til i dag ved middagstid. Andre almindelige handlinger er \now, \date og \time til at indsætte den aktuelle dato og det aktuelle klokkeslæt.
Se kapitlet Teksthandlinger — snydeark for et komplet overblik over alle handlinger.
Handlinger kan også bruges som pladsholdere i skabeloner, se kapitlet Oprettelse og brug af skabeloner.
Sådan undgår du markdown-fortolkning
Selvom markdown-genvejene kan være super nyttige og hurtige, er der tidspunkter, hvor du måske ikke vil have, at noget genkendes som markdown. Du kan escape ovenstående markdown-sekvenser ved først at skrive et tegn med omvendt skråstreg \ efterfulgt af det, du normalt ville skrive. Når du trykker på mellemrum, skulle tegnet med omvendt skråstreg automatisk forsvinde, og teksten skulle blive stående, som du skrev den. Skriver du for eksempel \1. Noget, giver det ikke en nummereret liste, men teksten 1. Noget.
Bemærk, at markdown aldrig fortolkes inde i tekst, der har afsnitsstilen Preformatted eller den indlejrede stil Fixed Width.
