Markdown-jukselapp
Agenda er ikke en markdown-editor, men den gjenkjenner en del markdown-syntaks for å bruke stiler. Her er markdown-snarveiene du kan bruke.
Avsnittsstiler
Følgende stiler endrer utseendet til hele avsnittet.
Overskrift
Bruk 1–6 firkanttegn i begynnelsen av linjen, etterfulgt av et mellomrom. Overskriftsnivået bestemmes av antall firkanttegn. F.eks. ### Eksempel gir en overskrift på tredje nivå.
Strek- eller punktliste
Begynn en linje med et kulepunkt, en bindestrek, en stjerne eller et plusstegn for å lage et strekpunkt. F.eks. • Eksempelpunkt 1 - Eksempelpunkt 2 * Eksempelpunkt 3 + Eksempelpunkt 4 gir et strek- eller kulepunkt.
Nummerert liste
Begynn en linje med et tall etterfulgt av punktum og et mellomrom for å lage et nummerert listepunkt. F.eks. \1. Eksempelpunkt 1 gir et nummerert listepunkt.
For å starte en nummerert liste på et annet tall enn 1 bruker du ganske enkelt det tallet F.eks. \3. Eksempelpunkt 3 gir et nummerert listepunkt som starter på 3.
Sjekkliste
Begynn en linje med en bindestrek etterfulgt av en åpnende og en lukkende hakeparentes. Setter du inn en «x» mellom de to parentesene, blir punktet avkrysset. F.eks. - [ ] Eksempel gir et sjekklistepunkt.
- [x] Eksempel gir et avkrysset punkt.
Bindestreken er valgfri, så du kan også lage en avkrysningsrute bare ved hjelp av to hakeparenteser.
Forhåndsformatert
For innhold som fungerer best med en skrift med fast bredde, som datakode, kan du bruke stilen forhåndsformatert. Du utløser denne stilen ved å begynne linjen med tre bakoverfnutter.
F.eks.
```eksempel gir eksempel
Kode
Agenda støtter syntaksfarging av datakode. Ved å legge til språket etter de tre bakoverfnuttene kan du angi hvilket språk kodesnutten er skrevet i.
F.eks.
```swift int i = 0; gir int i = 0 farget etter Swift-språket
En fullstendig liste over alle støttede språkparametere vedlikeholdes av highlight.js-prosjektet på https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.
Blokksitat
Bruk ett eller flere >-tegn i begynnelsen av linjen, etterfulgt av et mellomrom. Antallet >-tegn bestemmer sitatnivået, som vises med de loddrette strekene foran teksten.
F.eks.
> Eksempel gir
Eksempel
Innebygde stiler
Disse stilene brukes inne i avsnitt for å endre tekstens utseende.
Kursiv
Omslutning med understreker eller stjerner gir kursiv stil. F.eks. _eksempel_ eller *eksempel* gir eksempel
Fet
Omslutning med doble understreker eller doble stjerner gir fet stil. F.eks. __eksempel__ eller **eksempel** gir eksempel
Gjennomstreking
Omslutning med doble tilder gir gjennomstreket stil.
F.eks.
~~eksempel~~ gir eksempel
Fast bredde (fastbreddeskrift)
For noe innhold, som kildekode, er det å foretrekke med tekst med fast bredde. For tekstblokker er det best å bruke avsnittsstilen Forhåndsformatert. For innebygd tekst kan du omslutte med bakoverfnutter.
F.eks.
`eksempel` gir eksempel
Utheving
Omslutning med doble likhetstegn eller kolon gir uthevet stil. F.eks. ==eksempel== eller ::eksempel:: uthever ordet eksempel
Sett inn
Noen stiler er ikke knyttet til tekstens betydning, men brukes til å avgrense informasjonselementer som merkelapper. Disse kan også skrives inn med markdown-lignende syntaks.
Merkelapper
For å skrive inn en merkelapp bruker du bare et #-symbol, etterfulgt av merkelappen. Merkelappen kan ikke inneholde mellomrom.
F.eks.
Skriv #giraffes for å opprette en merkelapp som heter «giraffes».
Skriver du et #, utløses forslagsvinduet som hjelper deg å finne merkelappen du er ute etter.
Merkelapper kan også inneholde en parameter i parenteser. For eksempel #due(12/12/2018). Vil du lære mer om hvordan du får full nytte av parametere i merkelapper, se kapitlet Merkelapper, personer, teksthandlinger og lenker.
Personmerkelapper
Agenda gjenkjenner en annen type merkelapp som er forbeholdt enkeltpersoner. Du kan skrive inn et navn eller initialer for å vise til en venn eller kollega. Bare skriv et @-symbol foran teksten.
F.eks.
Skriv @Tom for å opprette en personmerkelapp for noen som heter «Tom».
Skriver du en @, utløses forslagsvinduet som hjelper deg å finne personen du er ute etter.
Emoji
For å sette inn en emoji skriver du bare et : (kolontegn), etterfulgt av kortnavnet til emojien, og et avsluttende : igjen.
F.eks.
Skriv :+1: for å sette inn emojien 👍.
Skriver du et :, utløses forslagsvinduet som hjelper deg å finne emojien du er ute etter.
Horisontal linje
Liker du å skille seksjoner i notatene dine visuelt med en horisontal linje, kan du gjøre det ved å skrive tre bindestreker på rad etterfulgt av et mellomrom:
F.eks.
Skriv --- for å lage en horisontal linje.
Tips: Importerer du en markdown-fil, kan du få den delt opp i enkeltnotater i Agenda ved hjelp av de samme tre bindestrekene på rad: F.eks. Første notat
---Andre notatDette lager to forskjellige notater, det første med innholdet «Første notat», og det andre med innholdet «Andre notat».
Tabeller
Agenda gir deg muligheten til å sette inn tabeller i notatene dine, som du raskt kan lage ved å skrive tre eller flere loddrette streker (|) på rad i begynnelsen av linjen:
F.eks.
Skriv ||| for å sette inn en tabell.
Lenker
Lenker gjenkjennes automatisk i tekst, men du kan også legge dem til med markdown-syntaks. Bruk hakeparenteser til å omslutte teksten som vises, etterfulgt av parenteser som omslutter lenke-URL-en. F.eks. Skriv [Agenda](agenda.com) for å lage en lenke til agenda.com knyttet til teksten «Agenda».
Teksthandlinger
Selv om det ikke strengt tatt er en del av klassisk markdown-syntaks, lar Agenda deg utløse visse handlinger hvis du begynner med å skrive et omvendt skråstrek-symbol , etterfulgt av en handling.
For eksempel vil \remind utløse innsetting av en påminnelse i notatet ditt. Valgfrie parametere kan oppgis som en del av handlingen; for eksempel vil \remind(today at noon) planlegge en påminnelse for i dag klokken tolv. Andre vanlige handlinger er \now, \date og \time, som setter inn gjeldende dato og klokkeslett.
For en fullstendig oversikt over alle handlinger, se kapitlet Jukselapp for teksthandlinger.
Handlinger kan også brukes som plassholdere i maler; se kapitlet Å lage og bruke maler.
Å hindre markdown-tolkning
Selv om markdown-snarveiene kan være superpraktiske og raske, finnes det tilfeller der du kanskje ikke vil at noe skal gjenkjennes som markdown. Du kan gjøre de ovennevnte markdown-sekvensene om til vanlig tekst ved først å skrive en omvendt skråstrek \, etterfulgt av det du vanligvis ville skrevet. Når du trykker mellomrom, skal den omvendte skråstreken forsvinne automatisk, og teksten bli stående slik du skrev den. Skriver du for eksempel \1. Noe, blir det ingen nummerert liste, men teksten 1. Noe.
Merk at markdown aldri tolkes inne i tekst som har avsnittsstilen Forhåndsformatert og den innebygde stilen Fast bredde.
