Lathund för markdown

Agenda är inte en markdown-redigerare, men den känner igen viss markdown-syntax för att tillämpa stilar. Här är de markdown-genvägar som kan användas.

Styckestilar

Följande stilar ändrar utseendet på hela stycket.

Rubrik

Använd 1–6 brädgårdssymboler i början av raden, följt av ett mellanslag. Rubriknivån bestäms av antalet brädgårdar. T.ex. ### Exempel ger en rubrik på tredje nivån.

Streckad eller punktlista

Inled en rad med en punkt, ett bindestreck, en asterisk eller ett plustecken för att skapa ett listobjekt med streck. T.ex. • Exempelobjekt 1 - Exempelobjekt 2 * Exempelobjekt 3 + Exempelobjekt 4 ger ett listobjekt med streck eller punkt.

Numrerad lista

Inled en rad med en siffra följd av en punkt och ett mellanslag för att skapa ett numrerat listobjekt. T.ex. \1. Exempelobjekt 1 ger ett numrerat listobjekt.

För att börja en numrerad lista på ett annat tal än 1 använder du helt enkelt det talet T.ex. \3. Exempelobjekt 3 ger ett numrerat listobjekt som börjar på 3.

Checklista

Inled en rad med ett bindestreck följt av en inledande hakparentes och en avslutande hakparentes. Om du sätter ett ”x” mellan de två hakparenteserna skapas ett markerat objekt. T.ex. - [ ] Exempel ger ett checklisteobjekt.

- [x] Exempel ger ett markerat objekt.

Bindestrecket är valfritt, så du kan även skapa en kryssruta med enbart två hakparenteser.

Förformaterad

För innehåll som fungerar bäst med ett teckensnitt med fast bredd, till exempel datorkod, kan du tillämpa stilen förformaterad. Du utlöser den stilen genom att inleda raden med tre bakåtfnuttar. T.ex. ```exempel ger exempel

Kod

Agenda stöder syntaxfärgning av datorkod. Genom att lägga till språket efter de tre bakåtfnuttarna kan du ange vilket språk kodsnutten är skriven i. T.ex. ```swift int i = 0; ger int i = 0 färgad enligt språket Swift

En fullständig lista över alla språkparametrar som stöds underhålls av projektet highlight.js på https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Blockcitat

Använd en eller flera >-symboler i början av raden, följt av ett mellanslag. Antalet >-tecken bestämmer citatnivån, som visas med de lodräta linjerna före texten. T.ex. > Exempel ger

Exempel

Infogade stilar

Dessa stilar används inuti stycken för att ändra textens utseende.

Kursiv

Om du omsluter med understreck eller asterisker får du kursiv stil. T.ex. _exempel_ eller *exempel* ger exempel

Fet

Om du omsluter med dubbla understreck eller dubbla asterisker får du fet stil. T.ex. __exempel__ eller **exempel** ger exempel

Genomstruken

Om du omsluter med dubbla tilde-tecken får du genomstruken stil. T.ex. ~~exempel~~ ger exempel

Fast bredd (monospace)

För visst innehåll, till exempel källkod, är det att föredra att ha text med fast bredd. För textblock är det bäst att använda styckestilen Förformaterad. För infogad text kan du omsluta med bakåtfnuttar. T.ex. `exempel` ger exempel

Markera

Om du omsluter med dubbla likhetstecken eller kolon får du markeringsstil. T.ex. ==exempel== eller ::exempel:: markerar ordet exempel

Infoga

Vissa stilar är inte kopplade till textens innebörd, utan används för att avgränsa informationselement som taggar. Även dessa kan matas in med markdown-liknande syntax.

Taggar

För att mata in en tagg använder du bara en #-symbol följd av taggen. Taggen får inte innehålla mellanslag. T.ex. Skriv #giraffes för att skapa en tagg som heter ”giraffes”.

När du skriver en # visas en popover för automatisk komplettering som hjälper dig att hitta taggen du söker.

Taggar kan också innehålla en parameter inom parentes. Till exempel #due(12/12/2018). För att lära dig mer om hur du får ut mesta möjliga av parametrar i taggar, se kapitlet Taggar, personer, textåtgärder och länkar.

Persontaggar

Agenda känner igen en andra typ av tagg som är reserverad för individer (personer). Du kan ange ett namn eller initialer för att hänvisa till en vän eller kollega. Sätt bara en @-symbol framför texten. T.ex. Ange @Tom för att skapa en persontagg för någon som heter ”Tom”.

När du skriver ett @ visas en popover för automatisk komplettering som hjälper dig att hitta personen du söker.

Emoji

För att mata in en emoji skriver du bara ett : (kolontecken), följt av emojins kortnamn och sedan ett avslutande : igen. T.ex. Skriv :+1: för att infoga emojin 👍.

När du skriver ett : visas en popover för automatisk komplettering som hjälper dig att hitta emojin du söker.

Horisontell linje

Om du vill avgränsa avsnitt visuellt i dina anteckningar med en horisontell linje kan du göra det genom att skriva tre bindestreck i rad följt av ett mellanslag: T.ex. Ange --- för att skapa en horisontell linje.

Tips: Om du importerar en markdown-fil kan du få den uppdelad i enskilda anteckningar i Agenda med samma tre bindestreck i rad: T.ex. Första anteckningen --- Andra anteckningen

Detta skapar två olika anteckningar, den första med innehållet ”Första anteckningen” och den andra med innehållet ”Andra anteckningen”.

Tabeller

Agenda ger dig möjlighet att infoga tabeller i dina anteckningar, som du snabbt kan skapa genom att skriva tre eller fler lodstreck (|) i rad i början av raden: T.ex. Ange ||| för att infoga en tabell.

Länkar

Länkar känns igen automatiskt i text, men du kan också lägga till dem med markdown-syntax. Använd hakparenteser för att omsluta texten som visas, följt av parenteser som omsluter länkens URL. T.ex. Ange [Agenda](agenda.com) för att skapa en länk till agenda.com kopplad till texten ”Agenda”.

Textåtgärder

Även om det inte strikt hör till klassisk markdown-syntax låter Agenda dig utlösa vissa åtgärder om du börjar med att skriva ett omvänt snedstreck \ följt av en åtgärd.

Till exempel kommer \remind att utlösa infogning av en påminnelse i din anteckning. Valfria parametrar kan anges som en del av åtgärden, till exempel schemalägger \remind(today at noon) en påminnelse till idag klockan tolv. Andra vanliga åtgärder är \now, \date och \time, för att infoga aktuellt datum och aktuell tid.

För en fullständig översikt över alla åtgärder, se kapitlet Lathund för textåtgärder.

Åtgärder kan också användas som platshållare i mallar, se kapitlet Skapa och använda mallar.

Förhindra markdown-tolkning

Även om markdown-genvägarna kan vara superanvändbara och snabba finns det tillfällen då du inte vill att något ska tolkas som markdown. Du kan undanta ovanstående markdown-sekvenser genom att först skriva ett omvänt snedstreck \ och därefter det du normalt skulle skriva. När du trycker på mellanslag bör det omvända snedstrecket automatiskt försvinna och texten bli kvar precis som du skrev den. Om du till exempel skriver \1. Något blir det ingen numrerad lista utan texten 1. Något.

Observera att markdown aldrig tolkas inuti text som har styckestilen Preformatted eller den infogade stilen Fixed Width.