Markdown Anleitung

Markdown ist eine einfache Möglichkeit, Text zu formatieren, der auf jedem Gerät gut aussieht. Es macht nichts Schönes, wie die Schriftgröße, die Farbe oder den Typ zu ändern — nur das Wesentliche, indem Sie Tastatursymbole verwenden, die Sie bereits kennen. Da es reiner Text ist, ist es eine einfache Möglichkeit, Notizen und Dokumente zu verfassen und kann bei Bedarf in ein Rich-Text-HTML-Dokument umgewandelt werden.

Joplin Desktop und mobile Anwendungen können sowohl den Markdown Text als auch das gerenderte Rich Text Dokument anzeigen.

Joplin folgt der CommonMark Spezifikation mit zusätzlichen Features über Plugins.

Spickzettel

Dies ist eine kurze Zusammenfassung der Markdown-Syntax.

	Markdown	Gerenderte Ausgabe
Überschrift 1	`# Überschrift 1`	Überschrift 1
Überschrift 2	`## Überschrift 2`	Überschrift 2
Überschrift 3	`### Überschrift 3`	Überschrift 3
Bold	`Dies ist ein fett geschriebener Text`	Dies ist ein paar Fett Text
Italic	`Dies ist ein paar kursiver Text`	Dies ist ein kursiver Text
Blockzitate	`> Kent. > Wo ist der König? > Gent. > Treten Sie mit den > frech Elemente`	> Kent. > Wo ist der König? > Gent. > Er kämpft mit den > stürmischen Elementen
Liste	`- Milch - Eier - Bier - Desperados - Heineken - Schinken`	Milch Eier Bier Desperados Heineken Schinken
Gegliederte Liste	`1. Einführung 2. Hauptthema 1. Erstes Unterthema 2. Zweites Unterthema 3. Schlussfolgerung`	Einführung Hauptthema Erstes Unterthema Zweites Unterthema Schlussfolgerung
Inline-Code	Dies ist `someJavaScript()`	Dies ist `someJavaScript()`
Code-Block	Hier ist ein gewisser JavaScript-Code: ``` Funktion hello() { alert('hello'); } ``` Sprache wird normalerweise automatisch erkannt, aber es kann auch angegeben werden: ```sql SELECT * FROM users; DELETE FROM sessions; ```	Hier ist ein gewisser JavaScript-Code: `Funktion hello() { alert('hello'); }` Die Sprache wird normalerweise automatisch erkannt, kann aber auch angegeben werden: `SELECT * FROM users; DELETE FROM sessions;`
Unformatierter Text	`Einrücken mit einem Tab oder 4 Leerzeichen für unformatierten Text. Dieser Text wird nicht formatiert: Robert'); DROP TABLE students;--`	Einrücken mit einem Tab oder 4 Leerzeichen für unformatierten Text. `Dieser Text wird nicht formatiert: Robert'); DROP TABLE students;--`
Link	`Dies wird als Link erkannt: https://joplinapp.org Und dies ist ein Link, der Textinhalt verankert: [Joplin](https://joplinapp.org) Und dies ist ein Link mit einem Titel, der Textinhalt verankert: [Joplin](https://joplinapp.org „Joplin-Projektseite”)`	Dies wird als Link erkannt: https://joplinapp.org Und dies ist ein Link, der Textinhalt verankert: Joplin Und dies ist ein Link mit einem Titel, der Textinhalt verankert: Joplin (Hinweis: Bewegen Sie den Mauszeiger über den Link)
Bilder	`![Joplin icon](https://git.io/JenGk)`
Horizontale Linie	`Eine Linie: *** Eine andere Linie: ---`	Eine Linie:

Eine andere Linie:

Tabellen

Tabellen werden mit Hilfe von Pipes | und Bindestrichen - erstellt. Dies ist eine Markdown Tabelle:

| Erste Kopfzeile  | Zweite Kopfzeile |
| ------------- | ------------- |
| Inhaltszelle  | Inhaltszelle  |
| Inhaltszelle  | Inhaltszelle  |

Welche gerendert wird als:

Erste Kopfzeile	Zweite Kopfzeile
Inhaltszelle	Inhaltszelle
Inhaltszelle	Inhaltszelle

Beachten Sie, dass es mindestens 3 Bindestriche geben muss, die jede Kopfzeilenzelle trennen.

Kolonien können verwendet werden, um Spalten auszurichten:

| Tabellen        | Sind           | Cool  |
| ------------- |:-------------:| -----:|
| Spalte 3 ist      | right-aligned | 1600 $ |
| Spalte 2 ist      | centered      |   12 $ |

Welche gerendert wird als:

Tabellen	Sind	Cool
Spalte 3 ist	rechts ausgerichtet	1600 $
Spalte 2 ist	zentriert	12 $

Joplin Extras

Neben der Standard Markdown Syntax unterstützt Joplin einige zusätzliche Features.

Links zu anderen Notizen

Sie können einen Link zu einer Notiz erstellen, indem Sie dessen ID in der URL angeben. Zum Beispiel:

[Link zu meiner Notiz](:/0b0d62d15e60409dac34f354b6e9e839)

Da es nicht einfach ist, die ID einer Notiz zu erhalten, bietet jede App eine Möglichkeit, einen solchen Link zu erstellen. In der Desktop-App ziehen Sie eine Notiz in eine andere Notiz um einen Link zu erstellen. Oder klicken Sie mit der rechten Maustaste auf eine Notiz und wählen Sie "Markdown-Link kopieren". Öffnen Sie in der mobilen App eine Notiz und wählen Sie im Menü oben rechts den "Markdown-Link kopieren". Sie können diesen Link dann irgendwo in eine andere Notiz einfügen.

Mathematische Schreibweise

Mathematische Ausdrücke können mit der KaTeX-Notation hinzugefügt werden. Um eine Inline-Gleichung hinzuzufügen, setzen Sie den Ausdruck in $EXPRESSION$ , z. B. $\sqrt{3x-1}+(1+x)^2$ . Um einen Ausdrucksblock zu erstellen, umschließen Sie ihn wie folgt:

$$
EXPRESSION
$$

Zum Beispiel:

$$
f(x) = \int_{-\infty}^\infty
    \hat f(\xi)\,e^{2 \pi i \xi x}
    \,d\xi
$$

Hier ist ein Beispiel mit dem Markdown und das Ergebnis nebeneinander gerendert:

Chemische Gleichungen

Joplin unterstützt chemische Gleichungen über das mhchem Plugin für KaTeX. Dieses Plugin wird automatisch aktiviert, wenn Sie die Mathematische Schreibweise aktivieren. Siehe mhchem Dokumentation für die Syntax.

Diagramme

Sie können Diagramme in Joplin mit der Mermaid Syntax erstellen. Um eine solche Grafik hinzuzufügen, umschließen Sie das Mermaid-Skript wie folgt mit einem „```mermaid”-Code-Block:

\mermaid
Diagramm TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
\

So würde es mit dem Markdown auf der linken Seite aussehen, und dargestellte Grafik auf der rechten Seite:

Mermaid-Unterstützung in Joplin

Beachten Sie, dass Mermaid-Grafiken unabhängig vom aktuellen Theme immer auf weißem Hintergrund dargestellt werden. Das liegt daran, dass sie verschiedene Farben enthalten können, die möglicherweise nicht mit dem aktuellen Thema kompatibel sind.

Kontrollkästchen

Checkboxen können wie folgt hinzugefügt werden:

- [ ] Milch
- [x] Reis
- [ ] Eier

Was zu folgendem Ergebnis führen würde:

Checkbox-Unterstützung in Joplin

Die Kontrollkästchen können dann in den mobilen und Desktop-Anwendungen angekreuzt werden.

HTML-Unterstützung

Es wird in der Regel empfohlen, die Notizen als Markdown einzugeben, da es die Notizen einfacher zu bearbeiten ist. In Fällen, in denen bestimmte Funktionen nicht unterstützt werden (z. B. Durchstreichen oder Hervorheben von Text), können Sie jedoch auch direkt HTML-Code verwenden. Zum Beispiel wäre dies eine gültige Notiz:

Dies ist <s>durchgestrichener Text</s> gemischt mit normaler **Markdown**.

Markdown Plugins

Joplin unterstützt eine Reihe von Plugins, die ein-/ausgeschaltet werden können, um Markdown Features auf den Standardfunktionen zu (de-)aktivieren. Diese Plugins sind unten aufgelistet. Im Gegensatz zu normalen Plugins müssen Markdown Plugins im Markdown Bereich des Konfigurationsbildschirms aktiviert werden. Nicht alle Plugins sind standardmäßig aktiviert. Wenn das Feld „Aktiviert“ unten auf „Nein“ steht, öffnen Sie den Optionsbildschirm, um das Plugin zu aktivieren. Plugins können auf die gleiche Weise deaktiviert werden.

Die durch diese Plugins hinzugefügten Funktionen sind nicht Teil der CommonMark-Spezifikation. Sie funktionieren zwar alle in Joplin, es kann jedoch nicht garantiert werden, dass sie auch in anderen Markdown-Readern funktionieren. Oftmals ist dies kein Problem, aber denken Sie daran, wenn Sie Kompatibilität mit anderen Markdown-Anwendungen benötigen.

Plugin	Syntax	Beschreibung	Aktiviert	Screenshot
Weiche Pausen	Breaks Markdown-it-Demo ansehen	Joplin verwendet standardmäßig harte Pausen, was bedeutet, dass ein Zeilenumbruch als `<br>` dargestellt wird. Weiche Pausen für das traditionelle Verhalten von Markdown Line-Breaks aktivieren.	o	Ansicht
Typograf	Typografen Markdown-it Demo ansehen	Ersetzt typografische Ersetzungen, (c) -> ©️ und so weiter	o	Ansicht
Linkify	linkify Markdown-it-Demo ansehen	URLs automatisch erkennen und in anklickbare Links konvertieren	ja
Katex	`$$math expr$$` oder $math$	Siehe oben	ja	Ansicht
Fontäne	```fountain Dein Screenplay... ```	Fügt Unterstützung für die Fountain-Markup-Sprache hinzu, eine Klartext-Markup-Sprache für Screenwriting	o	Ansicht
Mermaid	```mermaid mermaid syntax... ```	Siehe Plugin-Seite für vollständige Beschreibung	ja	Ansicht
Markierung	`==markiert==`	Wird umgewandelt in `<mark>markiert</mark>` (hervorgehoben)	ja	Ansicht
Fußnote	`Einfache Inline-Fußnote ^[Ich bin inline!]`	Siehe Plugin-Seite für vollständige Beschreibung	ja	Ansicht
TOC	Jeder der folgenden Befehle: `${toc}, [[toc]], [toc], [[_toc_]]`	Fügt ein Inhaltsverzeichnis zur Position der Toc-Seite hinzu. Basierend auf Überschriften und Unterüberschriften	ja	Ansicht
Sub	`X~1~`	Wird umgewandelt in X₁	o	Ansicht
Sup	`X ^2 ^`	Wird umgewandelt in X²	o	Ansicht
Deflist	Siehe pandoc Seite für Syntax	Fügt das HTML- `<dl>` Tag hinzu, das durch Markdown zugänglich ist	o	Ansicht
Abbr	*[HTML]: Hyper Text Markup Sprache Die HTML-Spezifikation	Ermöglicht die Definition von Abkürzungen, die später für eine vollständige Erweiterung überschritten werden können	o	Ansicht
Emoji	`:smile:`	Wird umgewandelt in 😄. Siehe diese Liste für weitere Emojis	o	Ansicht
Insert	`+++eingefügt++`	Wird umgewandelt in `<ins>mit</ins>` (eingefügt)	o	Ansicht
Multitabelle	Siehe MultiMarkdown Seite	Fügt mehr Kraft und Anpassung zu Markdown Tabellen hinzu	o	Ansicht

Markdown Anleitung

Spickzettel​

Überschrift 1

Überschrift 2

Überschrift 3

Tabellen​

Joplin Extras​

Links zu anderen Notizen​

Mathematische Schreibweise​

Chemische Gleichungen​

Diagramme​

Kontrollkästchen​

HTML-Unterstützung​

Markdown Plugins​