Markdown-Spickzettel

Agenda ist kein Markdown-Editor, erkennt aber einige Markdown-Syntaxelemente, um Stile anzuwenden. Hier sind die Markdown-Kurzschreibweisen, die du verwenden kannst.

Absatzstile

Die folgenden Stile verändern das Erscheinungsbild des gesamten Absatzes.

Überschrift

Verwende 1 bis 6 Rautezeichen am Zeilenanfang, gefolgt von einem Leerzeichen. Die Anzahl der Rauten bestimmt die Überschriftenebene. Beispiel: ### Beispiel erzeugt eine Überschrift der dritten Ebene.

Strich- oder Aufzählungsliste

Beginne eine Zeile mit einem Aufzählungspunkt, Bindestrich, Sternchen oder Pluszeichen, um ein Objekt einer Strichliste zu erzeugen. Beispiel: • Beispielobjekt 1 - Beispielobjekt 2 * Beispielobjekt 3 + Beispielobjekt 4 erzeugt ein Objekt einer Strich- oder Aufzählungsliste.

Nummerierte Liste

Beginne eine Zeile mit einer Zahl, gefolgt von einem Punkt und einem Leerzeichen, um ein Objekt einer nummerierten Liste zu erzeugen. Beispiel: \1. Beispielobjekt 1 erzeugt ein Objekt einer nummerierten Liste.

Um eine nummerierte Liste mit einer anderen Zahl als 1 zu beginnen, verwende einfach diese Zahl. Beispiel: \3. Beispielobjekt 3 erzeugt ein Objekt einer nummerierten Liste, die bei 3 beginnt.

Checkliste

Beginne eine Zeile mit einem Bindestrich, gefolgt von einer öffnenden und einer schließenden eckigen Klammer. Ein „x“ zwischen den beiden Klammern erzeugt ein abgehaktes Objekt. Beispiel: - [ ] Beispiel erzeugt ein Objekt einer Checkliste.

- [x] Beispiel erzeugt ein abgehaktes Objekt.

Der Bindestrich ist optional, du kannst ein Ankreuzfeld also auch nur mit zwei eckigen Klammern erzeugen.

Preformatted

Für Inhalte, die sich am besten in einer Schrift mit fester Zeichenbreite machen, etwa Programmcode, kannst du den Stil „Preformatted“ anwenden. Du löst diesen Stil aus, indem du die Zeile mit drei Backticks beginnst. Beispiel: ```sample erzeugt sample

Code

Agenda unterstützt die Syntaxfärbung von Programmcode. Indem du nach den drei Backticks die Sprache angibst, legst du fest, in welcher Sprache der Codeausschnitt geschrieben ist. Beispiel: ```swift int i = 0; erzeugt int i = 0, eingefärbt gemäß der Sprache Swift

Eine vollständige Liste aller unterstützten Sprachparameter wird vom Projekt highlight.js unter https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md gepflegt.

Blockzitat

Verwende ein oder mehrere >-Zeichen am Zeilenanfang, gefolgt von einem Leerzeichen. Die Anzahl der >-Zeichen bestimmt die Zitatebene, erkennbar an den senkrechten Linien vor dem Text. Beispiel: > Beispiel erzeugt

Beispiel

Inline-Stile

Diese Stile werden innerhalb von Absätzen verwendet, um das Erscheinungsbild des Texts zu ändern.

Kursiv

Text zwischen Unterstrichen oder Sternchen wird kursiv formatiert. Beispiel: _beispiel_ oder *beispiel* erzeugt beispiel

Fett

Text zwischen doppelten Unterstrichen oder doppelten Sternchen wird fett formatiert. Beispiel: __beispiel__ oder **beispiel** erzeugt beispiel

Durchgestrichen

Text zwischen doppelten Tilden wird durchgestrichen formatiert. Beispiel: ~~beispiel~~ erzeugt beispiel

Feste Zeichenbreite (Monospace)

Für manche Inhalte, etwa Programmquellcode, ist Text mit fester Zeichenbreite vorzuziehen. Für Textblöcke verwendest du am besten den Absatzstil Preformatted. Für Text innerhalb einer Zeile kannst du ihn in Backticks einschließen. Beispiel: `beispiel` erzeugt beispiel

Hervorheben

Text zwischen doppelten Gleichheitszeichen oder Doppelpunkten wird hervorgehoben. Beispiel: ==beispiel== oder ::beispiel:: hebt das Wort „beispiel“ hervor

Einfügen

Manche Stile haben nichts mit der Bedeutung des Texts zu tun, sondern dienen dazu, informative Elemente wie Tags abzugrenzen. Auch diese lassen sich mit einer Markdown-ähnlichen Syntax eingeben.

Tags

Um ein Tag einzugeben, verwendest du einfach ein #-Zeichen, gefolgt vom Tag. Das Tag darf keine Leerzeichen enthalten. Beispiel: Tippe #giraffes, um ein Tag namens „giraffes“ zu erstellen.

Beim Tippen eines # erscheint das Autovervollständigungs-Popover, das dir hilft, das gesuchte Tag zu finden.

Tags können auch einen Parameter in Klammern enthalten, zum Beispiel #due(12/12/2018). Mehr darüber, wie du Parameter in Tags voll ausnutzt, erfährst du im Kapitel Tags, Personen, Textaktionen und Links.

Personen-Tags

Agenda kennt einen zweiten Tag-Typ, der Einzelpersonen (Personen) vorbehalten ist. Du kannst einen Namen oder Initialen eingeben, um auf eine Freundin, einen Freund oder eine Kollegin bzw. einen Kollegen zu verweisen. Stelle dem Text einfach ein @-Zeichen voran. Beispiel: Gib @Tom ein, um ein Personen-Tag für jemanden namens „Tom“ zu erstellen.

Beim Tippen eines @ erscheint das Autovervollständigungs-Popover, das dir hilft, die gesuchte Person zu finden.

Emoji

Um ein Emoji einzugeben, tippst du einfach ein : (Doppelpunkt), gefolgt vom Kürzel des Emojis und einem abschließenden :. Beispiel: Tippe :+1:, um das Emoji 👍 einzufügen.

Beim Tippen eines : erscheint das Autovervollständigungs-Popover, das dir hilft, das gesuchte Emoji zu finden.

Horizontale Linie

Wenn du Abschnitte in deinen Notizen optisch mit einer horizontalen Linie abgrenzen möchtest, tippst du dazu drei Bindestriche hintereinander, gefolgt von einem Leerzeichen: Beispiel: Gib --- ein, um eine horizontale Linie zu erzeugen.

Tipp: Wenn du eine Markdown-Datei importierst, kannst du sie mit denselben drei Bindestrichen hintereinander in einzelne Notizen in Agenda aufteilen lassen: Beispiel: Erste Notiz --- Zweite Notiz

Dadurch entstehen zwei verschiedene Notizen: die erste mit dem Inhalt „Erste Notiz“, die zweite mit dem Inhalt „Zweite Notiz“.

Tabellen

Agenda bietet dir die Möglichkeit, Tabellen in deine Notizen einzufügen. Du erstellst sie schnell, indem du am Zeilenanfang drei oder mehr senkrechte Striche (|) hintereinander tippst: Beispiel: Gib ||| ein, um eine Tabelle einzufügen.

Links

Links werden im Text automatisch erkannt, du kannst sie aber auch mit Markdown-Syntax hinzufügen. Setze den angezeigten Text in eckige Klammern und dahinter die Link-URL in runde Klammern. Beispiel: Gib [Agenda](agenda.com) ein, um einen Link auf agenda.com zu erzeugen, der mit dem Text „Agenda“ verknüpft ist.

Textaktionen

Auch wenn sie streng genommen nicht Teil der klassischen Markdown-Syntax sind, kannst du in Agenda bestimmte Aktionen auslösen, indem du zunächst einen Rückwärtsschrägstrich \ tippst, gefolgt von einer Aktion.

Zum Beispiel fügt \remind eine Erinnerung in deine Notiz ein. Optionale Parameter können als Teil der Aktion angegeben werden: \remind(today at noon) plant etwa eine Erinnerung für heute Mittag. Weitere gängige Aktionen sind \now, \date und \time, um das aktuelle Datum und die aktuelle Uhrzeit einzufügen.

Einen vollständigen Überblick über alle Aktionen findest du im Kapitel Spickzettel für Textaktionen.

Aktionen können auch als Platzhalter in Vorlagen dienen, siehe das Kapitel Vorlagen erstellen und verwenden.

Markdown-Verarbeitung verhindern

So nützlich und schnell die Markdown-Kurzschreibweisen auch sind – manchmal möchtest du nicht, dass etwas als Markdown erkannt wird. Du kannst die obigen Markdown-Sequenzen maskieren, indem du zuerst einen Rückwärtsschrägstrich \ tippst und dann das, was du normalerweise eingeben würdest. Sobald du ein Leerzeichen drückst, sollte der Rückwärtsschrägstrich automatisch verschwinden und der Text so bleiben, wie du ihn getippt hast. Tippst du zum Beispiel \1. Etwas, entsteht keine nummerierte Liste, sondern der Text 1. Etwas.

Beachte, dass Markdown innerhalb von Text mit dem Absatzstil Preformatted und dem Inline-Stil Fixed Width nie verarbeitet wird.