---
id: 516F2865-FBBA-420C-A5A2-960CC58F7E62
template: academic-paper
sortOrder: 1
createdAt: 2026-08-12T08:26:17Z
updatedAt: 2026-08-12T08:26:17Z
---

---
title: JZ Writer — Markdown Cheat-Sheet
author: JURZEL
date: 2026-08-11
---

# JZ Writer — Markdown Cheat-Sheet

Alle Befehle, die du im Editor verwenden kannst — mit dem, was sie im PDF bewirken.

---

## 1 · YAML-Frontmatter

Optionaler Metadaten-Block am Dokumentanfang — muss von `---` eingerahmt sein.
Alle Felder sind optional. Leere Felder werden ignoriert.

```
---
title: Titel des Dokuments
author: Vorname Nachname
date: 11. August 2026
subtitle: Untertitel
---
```

### Allgemeine Felder

| Schlüssel | Alternativschlüssel | Was er bewirkt |
|---|---|---|
| `title` | — | Dokumenttitel auf dem Deckblatt |
| `author` | — | Autorenname auf dem Deckblatt und in Kopf-/Fußzeile |
| `date` | — | Datum (freie Eingabe, z. B. `11. August 2026`) |
| `subtitle` | `untertitel` | Untertitel unter dem Haupttitel |
| `toc` | `inhaltsverzeichnis` | Inhaltsverzeichnis einfügen (`true` / `ja`) |
| `numbered_headings` | `nummerierung`, `gliederung` | Überschriften automatisch nummerieren (`true` / `ja`) |
| `chapter_pagebreak` | `chapter_break`, `kapitelumbruch` | Automatischer Seitenumbruch vor jeder H1-Überschrift (`true` / `ja`) |
| `citation_style` | `zitationsstil`, `literaturstil` | Zitationsstil: `apa`, `chicago`, `mla`, `ieee`, `numeric` |
| `lof` | `abbildungsverzeichnis` | Abbildungsverzeichnis nach dem Inhaltsverzeichnis einfügen (`true` / `ja`) |
| `lot` | `tabellenverzeichnis` | Tabellenverzeichnis nach dem Inhaltsverzeichnis einfügen (`true` / `ja`) |

### Hochschul-Felder (für Seminar- und Abschlussarbeiten)

| Schlüssel | Alternativschlüssel | Was er bewirkt |
|---|---|---|
| `course` | `kurs`, `seminar` | Kurs- / Seminarname auf dem Deckblatt |
| `student_id` | `matrikel`, `matrikelnummer` | Matrikelnummer |
| `supervisor` | `betreuer`, `erstgutachter` | Erstbetreuer / Prüfer |
| `supervisor2` | `zweitgutachter`, `co_supervisor` | Zweitbetreuer |
| `institute` | `hochschule`, `university`, `universität` | Hochschule / Universität |
| `department` | `fachbereich`, `studiengang`, `fakultät` | Fachbereich / Studiengang |
| `subject` | `fach`, `modul`, `lehrveranstaltung` | Fach / Modul |
| `chair` | `lehrstuhl`, `professur` | Lehrstuhl / Professur |
| `doctype` | `dokumenttyp`, `arbeitstyp` | Art der Arbeit (z. B. `Bachelorarbeit`) |
| `degree` | `abschluss`, `studienabschluss` | Abschlussgrad (z. B. `Bachelor of Arts`) |
| `semester` | `fachsemester` | Fachsemester (z. B. `5`) |
| `address` | `adresse`, `anschrift` | Anschrift des Verfassers |
| `email` | `e-mail` | E-Mail-Adresse |
| `location` | `ort`, `abgabeort` | Abgabeort |
| `period` | `zeitraum`, `bearbeitungszeitraum` | Bearbeitungszeitraum |

---

## 2 · Überschriften

Bis zu 6 Ebenen — `#` bis `######`.

```
# Überschrift Ebene 1
## Überschrift Ebene 2
### Überschrift Ebene 3
#### Überschrift Ebene 4
##### Überschrift Ebene 5
###### Überschrift Ebene 6
```

> Tipp: Mit `numbered_headings: true` im Frontmatter werden Überschriften automatisch nummeriert (`1.`, `1.1.`, `1.1.1.` …).

---

## 3 · Textformatierung (Inline)

| Syntax | Ergebnis im PDF |
|---|---|
| `**fett**` oder `__fett__` | **fett** |
| `*kursiv*` oder `_kursiv_` | *kursiv* |
| `***fett und kursiv***` | ***fett und kursiv*** |
| `~~durchgestrichen~~` | ~~durchgestrichen~~ |
| `` `Inline-Code` `` | Monospace-Schrift, unverändert |

---

## 4 · Listen

### Ungeordnete Liste

Marker: `-`, `*` oder `+` — alle gleichwertig.

```
- Erster Punkt
- Zweiter Punkt
  - Eingerückter Unterpunkt (2 Leerzeichen)
  - Noch ein Unterpunkt
- Dritter Punkt
```

### Geordnete Liste

```
1. Erster Schritt
2. Zweiter Schritt
   1. Untergeordnet (3 Leerzeichen Einrückung)
3. Dritter Schritt
```

> Einrückungstiefe: je 2 Leerzeichen = eine Ebene tiefer.

---

## 5 · Links

```
[Linktext](https://example.com)
```

Im PDF erscheint der Linktext als anklickbarer Hyperlink.

---

## 6 · Bilder

### Externes Bild (URL)

```
![Alternativtext](https://example.com/bild.jpg)
```

### Lokales Bild (aus App-Bibliothek)

```
![Alternativtext](local:dateiname.jpg)
```

> Lokale Bilder werden über den Bild-einfügen-Button in der Toolbar eingefügt — der Dateiname wird automatisch erzeugt.

### Bild mit Bildunterschrift (nummerierte Abbildung)

Der **Alternativtext** doppelt als Bildunterschrift. Ist er nicht leer, erscheint das Bild im PDF als nummerierte Abbildung mit Legende — automatisch im Abbildungsverzeichnis erfasst.

```
![Abb. 1: Schematische Darstellung des Prozesses](local:diagramm.png)
![Überblick der Systemarchitektur](https://example.com/architektur.png)
```

### Bild mit Beschriftungs-Box

```
#img_box[https://example.com/bild.jpg][Bildunterschrift]
#img_box[local:dateiname.jpg][Beschriftung]
```

Bild mit formatierter Unterschrift im PDF — ideal für Abbildungen in wissenschaftlichen Texten.

---

## 7 · Tabellen

Die erste Zeile wird als Kopfzeile formatiert.

```
| Spalte A    | Spalte B    | Spalte C    |
|-------------|-------------|-------------|
| Zelle 1     | Zelle 2     | Zelle 3     |
| Zelle 4     | Zelle 5     | Zelle 6     |
```

> Die Trennzeile muss mindestens 3 Bindestriche pro Spalte enthalten.

### Tabelle mit Tabellenunterschrift

Eine Zeile unmittelbar nach der Tabelle, die mit `Tabelle:` beginnt, wird zur nummerierten Tabellenunterschrift — automatisch im Tabellenverzeichnis erfasst.

```
| Begriff         | Beschreibung                    | Jahr  |
|-----------------|---------------------------------|-------|
| Superposition   | Gleichzeitige Quantenzustände   | 1926  |
| Verschränkung   | Korrelierte Quantenzustände     | 1935  |
Tabelle: Grundlegende Konzepte der Quantenmechanik
```

> `Tabelle:` muss **direkt** nach der letzten Tabellenzeile stehen, ohne Leerzeile dazwischen.

---

## 8 · Blockzitate

```
> Dies ist ein Zitat. Es wird im PDF als eingerückter
> Textblock dargestellt.
```

---

## 9 · Code-Blöcke

### Mehrzeiliger Code

````
```python
def hallo():
    print("Hallo Welt")
```
````

Der Sprachname nach den Backticks ist optional. Code-Blöcke werden im PDF nie über Seitenumbrüche getrennt.

---

## 10 · Trennlinien

Drei oder mehr gleiche Zeichen auf einer eigenen Zeile — alle gleichwertig:

```
---
***
___
```

Erscheint im PDF als horizontale Linie.

> `---` erzeugt eine **Trennlinie**, keinen Seitenumbruch. Für Seitenumbrüche → Abschnitt 11.

---

## 11 · Seitenumbruch

Fügt an der exakten Position einen Seitenumbruch ein. Alle Varianten sind gleichwertig:

```
\newpage
\pagebreak
[pagebreak]
[Seitenumbruch]
```

**Wichtig:** Der Befehl muss auf einer **eigenen, leeren Zeile** stehen.

```
Letzter Absatz auf Seite 1.

\newpage

Erster Absatz auf Seite 2.
```

> **Buchvorlagen:** In Vorlagen wie KDP 6×9, BoD A5 und Kindle gibt es keine automatischen Seitenumbrüche vor Kapitelüberschriften. Kapitelwechsel werden ausschließlich über `\newpage` gesteuert.

---

## 12 · Fußnoten

```
Hier steht Text mit einer Fußnote.[^fn1]

[^fn1]: Das ist der Fußnotentext, der am Seitenende erscheint.
```

> Fußnotendefinitionen (`[^label]: ...`) können überall im Dokument stehen — JZ Writer platziert sie automatisch am richtigen Seitenende.

---

## 13 · Zitationen (Literaturverweise)

Erfordert Einträge im Literaturverzeichnis (BibTeX-Format).

```
[@müller2023]
[@müller2023; @schmidt2021]
```

Im PDF erscheint die Quellenangabe im gewählten Zitationsstil (z. B. `[Müller, 2023]` oder `(Müller 2023)`).

---

## 14 · Inhaltsverzeichnis

Zwei gleichwertige Varianten:

```
[TOC]
[Inhaltsverzeichnis]
```

> Empfohlen: `toc: true` im YAML-Frontmatter — das Inhaltsverzeichnis erscheint dann automatisch vor dem Text auf einer eigenen Seite.

---

## 15 · Literaturverzeichnis

Fügt das Literaturverzeichnis an der gewünschten Stelle ein:

```
[bibliography]
[Literaturverzeichnis]
```

---

## 16 · Abbildungsverzeichnis

Fügt ein Abbildungsverzeichnis aller nummerierten Abbildungen an der gewünschten Stelle ein:

```
[LOF]
[Abbildungsverzeichnis]
```

> Empfohlen: `lof: ja` im YAML-Frontmatter — das Abbildungsverzeichnis erscheint dann automatisch nach dem Inhaltsverzeichnis.

---

## 17 · Tabellenverzeichnis

Fügt ein Tabellenverzeichnis aller nummerierten Tabellen an der gewünschten Stelle ein:

```
[LOT]
[Tabellenverzeichnis]
```

> Empfohlen: `lot: ja` im YAML-Frontmatter — das Tabellenverzeichnis erscheint dann automatisch nach dem Inhaltsverzeichnis.

---

## 18 · Stichwortregister (Index)

Markiert einen Begriff als Indexterm — im PDF bleibt der Begriff sichtbar, der Marker wird entfernt:

```
Die #index:Quantenmechanik ist ein Teilgebiet der Physik.
```

> Alle markierten Begriffe werden in der Dokumentstruktur-Ansicht der App gesammelt angezeigt.

---

## 19 · Emoji im PDF

Farbige Emoji (z. B. 😊) erscheinen im PDF nicht — die verwendeten Schriften enthalten keine Farbgrafiken. JZ Writer ersetzt rund 55 häufige Emoji automatisch durch passende Textsymbole.

### Automatische Ersetzungen

| Emoji | Im PDF | Farbe |
|-------|--------|-------|
| `✅` | ✓ | Grün |
| `❌` | ✗ | Rot |
| `⚠️` | △ | Orange |
| `⏭️` | ▷▷ | Grau |
| `🔁` | ↺ | Blau |
| `🔄` | ↻ | Blau |
| `🔴` `🟡` `🟢` `🔵` | ● | Farbig |
| `➡` `⬅` `⬆` `⬇` | → ← ↑ ↓ | Schwarz |
| `⭐` `🌟` | ★ | Schwarz |
| `👍` `👎` | [+] [−] | Schwarz |
| `📝` `📄` `📋` | [Notiz] [Dok] [Liste] | Schwarz |
| `💡` | [Hinweis] | Schwarz |
| `🏛` `🎓` | [Uni] [Abschl.] | Schwarz |

### Zuverlässige Symbole ohne Ersetzung

Diese Zeichen funktionieren in allen Schriften garantiert:

| Symbol | Bedeutung |
|--------|-----------|
| `✓` | Haken |
| `✗` | Kreuz |
| `→` | Pfeil rechts |
| `★` | Stern |
| `△` | Dreieck / Warnung |
| `↺` `↻` | Rotationspfeile |
| `●` `○` | Gefüllter / leerer Kreis |

---

## 20 · Kommentare (nur im Editor sichtbar)

Doppelt geschweifte Klammern — erscheinen **nicht** im PDF:

```
Dies ist normaler Text. {{Notiz für mich: Quelle prüfen!}}
```

> Ideal für Recherche-Notizen, To-dos und Überarbeitungshinweise direkt im Fließtext.

---

## 21 · Hervorgehobene Blöcke (Callouts)

Vier besondere Block-Typen für hervorgehobene Inhalte. Farbe, Rahmen und Symbol werden pro Vorlage im Vorlagen-Editor konfiguriert.

### Info-Box

```
#info_box[Hier steht ein wichtiger Hinweis oder Tipp.]
```

### Warn-Box

```
#warning_box[Achtung: Diese Einstellung kann nicht rückgängig gemacht werden.]
```

### Zitat-Block (Pull-Quote)

```
#quote_block[Der kürzeste Weg zur Erkenntnis ist das Experiment.]
```

Visuell eigenständiger Block — stärker betont als ein einfaches Blockzitat (`>`).

### Code-Block (gestylt)

```
#code_block[$ git commit -m "Erstes Kapitel"]
```

Für einzelne Codezeilen im Vorlagen-Stil. Mehrzeiliger Code → Standard-Code-Block (Abschnitt 9).

### Bild-Block

```
#img_box[local:dateiname.jpg][Beschriftung unter dem Bild]
```

---

## Vollständiges Beispiel

```markdown
---
title: Seminararbeit zur Quantenphysik
author: Max Mustermann
date: 11. August 2026
course: Einführung in die Theoretische Physik
student_id: 12345678
supervisor: Prof. Dr. Anna Schmidt
institute: Universität Musterstadt
toc: true
numbered_headings: true
---

# Einleitung

Die **Quantenmechanik** ist ein fundamentaler Bereich der Physik.[^fn1]
Sie beschreibt das Verhalten von Materie auf *atomarer* und subatomarer Ebene.

## Historischer Überblick

Die wichtigsten Entwicklungen waren:

1. Plancks Quantenhypothese (1900)
2. Einsteins Photoeffekt (1905)
   1. Nobelpreis 1921
3. Heisenbergs Unschärfeprinzip (1927)

---

## Grundlegende Konzepte

| Begriff         | Beschreibung                    | Jahr  |
|-----------------|---------------------------------|-------|
| Welle-Teilchen  | Dualismus der Materie           | 1923  |
| Superposition   | Gleichzeitige Zustände          | 1926  |
| Verschränkung   | Korrelierte Quantenzustände     | 1935  |

> „Wer die Quantenmechanik nicht schockierend findet,
> hat sie nicht verstanden." — Niels Bohr

Weitere Informationen auf [Wikipedia](https://de.wikipedia.org/wiki/Quantenmechanik).

[^fn1]: Griechisch: *quantus* = „wie groß", „wie viel".

[bibliography]
```

---

*Erstellt mit JZ Writer — JURZEL*