---
id: 88ECC0FA-31B1-467C-B736-FF19BAC60C45
template: academic-paper
createdAt: 2026-08-12T08:26:17Z
updatedAt: 2026-08-12T08:26:17Z
---

# JZ Writer — Bedienungsanleitung

**Version:** Version 1.0 · macOS 26+ · iOS 26+  
**Autor:** JURZEL · jurzel.de

---

> Diese Anleitung führt dich anhand realer Arbeitsabläufe durch alle Funktionen von JZ Writer.
> Jeder Abschnitt beginnt mit einem klaren Lernziel.
> Am Ende fungiert die Anleitung als vollständiges Nachschlagewerk.

---

# Teil 1 — Grundlagen

## Das Konzept von JZ Writer

> **Lernziel:** Du verstehst, wie JZ Writer Dokumente speichert und warum das Vault-System besser ist als eine Datenbank.

JZ Writer speichert alle Dokumente als einfache Textdateien.
Das Format ist Markdown — lesbar in jedem Texteditor.
Du brauchst keine App, um deine Texte zu lesen.
Du brauchst keine Synchronisation mit einem Server.
Alles liegt in einem Ordner auf deinem Mac oder iPhone — deinem **Vault**.

**Drei Kernbegriffe:**

| Begriff | Bedeutung |
|---------|-----------|
| **Vault** | Der Hauptordner, in dem alle Dateien liegen |
| **Gruppe** | Ein Unterordner im Vault (z. B. ein Roman, ein Projekt) |
| **Dokument** | Eine einzelne `.md`-Datei im Vault |

**Vorteile dieses Ansatzes:**

- Dateien sind portabel. Du kannst sie kopieren, per Mail verschicken, in Git verwalten.
- Kein Vendor-Lock-in. JZ Writer kann jederzeit durch jeden anderen Editor ersetzt werden.
- iCloud-Sync funktioniert automatisch, wenn du den Vault in iCloud Drive anlegst.
- Backups sind trivial — du sicherst einfach den Ordner. 

---

## Die Benutzeroberfläche

> **Lernziel:** Du erkennst alle Bereiche der App und weißt, wozu sie dienen.

JZ Writer hat auf macOS drei Spalten:

```
┌──────────────┬──────────────────────────────┬──────────────────┐
│   Sidebar    │          Editor              │    Vorschau      │
│              │                              │                  │
│ Bibliothek   │  Titelfeld                   │  PDF / Design /  │
│ Gruppen      │  ─────────────────           │  Veröffentlichen │
│ Dokumente    │  Textbereich                 │                  │
│              │                              │                  │
│              │  Statusleiste                │                  │
└──────────────┴──────────────────────────────┴──────────────────┘
```

**Die Sidebar** zeigt alle Gruppen und Dokumente.
**Der Editor** ist dein Schreibbereich — immer in der Mitte.
**Die Vorschau** (rechts) zeigt das fertige PDF oder den HTML-Render.

**Die drei Vorschau-Modi** (Tabs oben rechts):

| Modus | Inhalt |
|-------|--------|
| Schreiben | Live-PDF-Vorschau deines Dokuments |
| Gestalten | Vorlage auswählen und Typografie anpassen |
| Veröffentlichen | Export zu PDF, DOCX, EPUB, RTF, Druck |

**Die Toolbar** (oben) enthält alle wichtigen Aktionen:
Neues Dokument · Neue Gruppe · Vorlage · Schreibziel · Snapshot · KI-Panel · Fokus · Export

---

# Teil 2 — Einrichtung

## Den Vault einrichten

> **Lernziel:** Du richtest deinen persönlichen Vault ein und verstehst, wo deine Dateien gespeichert werden.

### Vault beim Erststart

Beim ersten Start fragt JZ Writer nach einem Vault-Ordner.

**Empfehlung für iCloud-Sync:**

1. `⌘⇧O` drücken oder **Ablage → Vault-Ordner öffnen …**
2. Im Finder: `iCloud Drive` → Neuer Ordner: `JZ Writer`
3. Ordner auswählen → "Öffnen" klicken

Alle Dokumente werden sofort zwischen deinen Geräten synchronisiert.

**Empfehlung ohne iCloud:**

1. Lokalen Ordner wählen, z. B. `~/Dokumente/JZ Writer`
2. Regelmäßige Time-Machine-Backups genügen als Sicherung

### Vault wechseln

Du kannst den Vault jederzeit wechseln.
Deine bisherigen Dokumente bleiben im alten Ordner erhalten.

**Wechsel über das Datei-Menü:**  
**Ablage → Vault-Ordner öffnen …** (macOS · `⌘⇧O`)

**Wechsel über die Einstellungen:**  
`⌘,` → Bereich "Vault (Speicherort)" → "Ordner wechseln …"

**Wechsel über die Toolbar:**  
Ordner-Icon in der Sidebar-Toolbar → "Ordner öffnen …"

### Vault im Finder anzeigen

**Ablage → Im Finder zeigen**  
*oder* Einstellungen → "Im Finder zeigen"

Der Vault-Ordner öffnet sich direkt im Finder.
Dort kannst du Dateien extern bearbeiten oder sichern.

> **Hinweis:** Wenn du Dateien extern hinzufügst, erkennt JZ Writer die Änderungen automatisch und aktualisiert die Sidebar.

---

# Teil 3 — Tägliches Schreiben

## Das erste Dokument

> **Lernziel:** Du erstellst, bearbeitest und speicherst dein erstes Dokument.

### Neues Dokument erstellen

**Tastaturkürzel:** `⌘N`  
**Toolbar:** Stift-Icon (oben links in der Sidebar)

Ein neues Dokument erscheint in der Sidebar mit dem Namen "Untitled".
Der Cursor springt direkt ins Titelfeld.

### Titel vergeben

1. Im Titelfeld (oben im Editor) den Titel eintippen
2. `Tab` oder Klick in den Textbereich

Der Dateiname im Vault passt sich automatisch an.
Sonderzeichen im Titel werden automatisch bereinigt.

### Text schreiben

Klick in den großen weißen Textbereich.
Tippe los — JZ Writer speichert automatisch.

**Auto-Save:** Jede Änderung wird nach **1,5 Sekunden** automatisch gespeichert.
Der Speicher-Timestamp erscheint neben dem Titel: `Gespeichert vor 3 s`

### Zwischen Dokumenten wechseln

Klick auf ein anderes Dokument in der Sidebar.
Das aktuelle Dokument wird vorher automatisch gespeichert.

---

## Der Editor

> **Lernziel:** Du kennst alle Möglichkeiten des Editors und nutzt ihn effizient.

### Schriftgröße und Zeilenabstand

`⌘,` → Bereich "Editor"

- **Schriftgröße:** 10–28 pt (Slider)
- **Zeilenabstand:** 1,0×–2,5× (Slider)

Änderungen werden sofort übernommen. Die Cursor-Position bleibt erhalten.

### Schriftart wählen

`⌘,` → Bereich "Schreiben" → Editor-Schrift

| Option | Eignet sich für |
|--------|-----------------|
| **Monospace** | Code, Markdown-Struktur sehen |
| **Serif (Prosa)** | Romane, Aufsätze, fließender Text |
| **Sans-Serif** | Notizen, Berichte, klare Lesbarkeit |

### Schreibmaschinen-Modus

`⌘,` → "Schreibmaschinen-Modus" aktivieren

Der Cursor bleibt beim Tippen immer in der **Bildschirmmitte**.
Ideal für langes, fokussiertes Schreiben ohne ablenkende Scrollbewegungen.

### Ghost-UI — unsichtbare Oberfläche

Nach 3 Sekunden ohne Eingabe verblasst die gesamte Oberfläche.
Nur der Cursor und der Text bleiben sichtbar.
Beim ersten Tastendruck kehrt alles zurück.

### Typografische Anführungszeichen

JZ Writer wandelt `"` automatisch in `„..."` (deutsches Format) um.
Das funktioniert im Fließtext, nicht in Code-Blöcken.

---

## Markdown-Formatierung

> **Lernziel:** Du formatierst Text mit Markdown und nutzt die Formatting-Toolbar.

### Formatting-Toolbar

Die Toolbar über dem Textbereich enthält Buttons für alle häufigen Formate:

`H1 H2 H3` · `**B**` · `*I*` · `~~S~~` · Liste · Tabelle · Link · Bild · Zitat · Code

**So funktioniert es:**
1. Text auswählen
2. Toolbar-Button klicken
3. Die Markdown-Syntax wird automatisch um den Text gesetzt

### Überschriften

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

Tipp: Mit `nummerierung: ja` im Frontmatter werden Überschriften automatisch nummeriert.

### Fettdruck und Kursiv

| Syntax | Ergebnis |
|--------|---------|
| `**fett**` | **fett** |
| `*kursiv*` | *kursiv* |
| `***fett und kursiv***` | ***fett und kursiv*** |
| `~~durchgestrichen~~` | ~~durchgestrichen~~ |
| `` `Code` `` | `Code` |

### Listen

**Ungeordnete Liste:**
```
- Erster Punkt
- Zweiter Punkt
  - Eingerückter Unterpunkt
```

**Geordnete Liste:**
```
1. Schritt eins
2. Schritt zwei
   1. Unterschritt
```

### Tabellen

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

**Tipp:** Den Tabellen-Editor über die Toolbar öffnen — er erzeugt die Syntax automatisch.

### Tabellenunterschriften

Eine Zeile unmittelbar nach der Tabelle, die mit `Tabelle:` beginnt, wird zur nummerierten Tabellenunterschrift:

```
| Messgröße | Wert  | Einheit |
|-----------|-------|---------|
| Spannung  | 3,3   | V       |
| Strom     | 0,5   | A       |
Tabelle: Elektrische Kennwerte des Prototyps
```

Die Tabelle erscheint im PDF nummeriert (z. B. *Tabelle 1*) und wird automatisch im Tabellenverzeichnis erfasst.

### Blockzitat

```
> Das ist ein Zitat.
> Es kann mehrere Zeilen haben.
```

### Code-Block

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

Code-Blöcke werden im PDF nie über Seitenumbrüche getrennt.
Formatierungen (fett, kursiv) innerhalb von Code-Blöcken werden nicht umgewandelt.

### Trennlinie

```
---
```

Erzeugt eine horizontale Linie im PDF.
**Wichtig:** `---` erzeugt eine Linie, keinen Seitenumbruch.

### Manueller Seitenumbruch

Für einen Seitenumbruch an einer bestimmten Stelle verwendest du einen der folgenden Befehle — alle vier sind gleichwertig:

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

Der Befehl muss auf einer eigenen, leeren Zeile stehen.

**Alternativ: Automatischer Kapitel-Umbruch** — füge `chapter_pagebreak: ja` ins Frontmatter ein, dann wird vor jeder H1-Überschrift automatisch ein neues Kapitel begonnen.

Du kannst den `\newpage`-Befehl auch über den **Toolbar-Button** (Symbol: Pfeil zur Linie) einfügen — er ist direkt in der Haupt-Toolbar sichtbar, ohne die erweiterte Leiste öffnen zu müssen.

### Fußnoten

```
Haupttext mit Fußnote.[^fn1]

[^fn1]: Das ist der Fußnotentext.
```

Die Fußnote erscheint im PDF am unteren Seitenrand.

### Interne Kommentare

```
Sichtbarer Text. {{Diese Notiz erscheint nur im Editor.}}
```

Alles in `{{doppelten Klammern}}` wird beim Export entfernt.
Perfekt für Überarbeitungshinweise und Recherche-Notizen.

---

## YAML-Frontmatter

> **Lernziel:** Du steuerst das Aussehen deines PDFs über Metadaten im Frontmatter.

Der Frontmatter-Block steht **ganz am Anfang** des Dokuments.
Er beginnt und endet mit `---`.

### Grundfelder

```
---
title: Titel des Dokuments
author: Dein Name
date: August 2026
subtitle: Untertitel (optional)
toc: ja
nummerierung: ja
---
```

| Feld | Beschreibung |
|------|-------------|
| `title` | Erscheint im PDF-Deckblatt |
| `author` | Autorenname |
| `date` | Datum (freies Format) |
| `subtitle` | Untertitel |
| `toc: ja` | Inhaltsverzeichnis einfügen |
| `nummerierung: ja` | Überschriften automatisch nummerieren |
| `chapter_pagebreak: ja` | Vor jeder H1-Überschrift automatisch neue Seite beginnen |
| `citation_style: apa` | Zitationsstil für Literaturverweise: `apa`, `chicago`, `mla`, `ieee`, `numeric` |
| `lof: ja` | Abbildungsverzeichnis nach dem Inhaltsverzeichnis einfügen |
| `lot: ja` | Tabellenverzeichnis nach dem Inhaltsverzeichnis einfügen |

### Hochschulfelder (Masterarbeit, Seminararbeit)

```
---
dokumenttyp: Masterarbeit
abschluss: Master of Science
universität: Universität Musterstadt
fachbereich: Wirtschaftswissenschaften
studiengang: Business Administration
lehrstuhl: Lehrstuhl für Digitales Management
matrikel: 12345678
betreuer: Prof. Dr. Marie Weiss
zweitgutachter: Dr. Thomas Kraft
semester: 4
ort: Musterstadt
zeitraum: April – September 2026
---
```

Eine vollständige Feldübersicht findest du im Dokument **JZ-Writer-Cheat-Sheet**.

---

# Teil 4 — Dokumente und Gruppen organisieren

## Dokumente verwalten

> **Lernziel:** Du erstellst, benennst, bewegst, duplizierst und löschst Dokumente sicher.

### Dokument umbenennen

Klick auf den Titel im Editor-Titelfeld → neuen Namen tippen → `Tab`

Der Dateiname im Vault passt sich automatisch an.

### Dokument löschen

Rechtsklick auf ein Dokument in der Sidebar → "Löschen"

**Achtung:** Die Datei wird aus dem Vault gelöscht. Das Löschen kann nicht rückgängig gemacht werden — stelle sicher, dass du vorher einen Snapshot angelegt hast.

### Dokument in eine Gruppe verschieben

**Drag & Drop:** Dokument aus der Sidebar auf eine Gruppe ziehen.

*oder*

Rechtsklick → "Verschieben nach …" → Gruppe auswählen

### Dokument aus einer Gruppe herauslösen

Dokument per Drag & Drop aus der Gruppe ganz nach oben in die Sidebar ziehen — in den ungruppierten Bereich.

---

## Gruppen (Ordner) verwalten

> **Lernziel:** Du strukturierst deinen Vault mit Gruppen für verschiedene Projekte.

### Neue Gruppe erstellen

**Toolbar:** Ordner-Icon (links oben in der Sidebar)  
**Tastaturkürzel:** `⌘⇧N`

Vergib einen sprechenden Namen: `Roman 2026`, `Dissertation`, `Kundenprojekte`.

### Gruppe umbenennen

Rechtsklick auf die Gruppe → "Umbenennen"

### Gruppe löschen

Rechtsklick auf die Gruppe → "Löschen"

**Achtung:** Alle Dokumente in der Gruppe werden ebenfalls gelöscht.

### Gruppen auf- und zuklappen

Klick auf den Pfeil links neben dem Gruppennamen.

### Projektfortschritt für eine Gruppe setzen

1. Rechtsklick auf Gruppe → "Gruppeninfo"
2. Projektziel (Wortanzahl) eintragen, z. B. `80000` für einen Roman

Der Fortschrittsbalken erscheint in der Gruppenansicht.

---

## Tags

> **Lernziel:** Du markierst Dokumente mit Tags und filterst danach.

### Tag hinzufügen

Rechtsklick auf ein Dokument → "Tags bearbeiten"  
Tag eingeben (z. B. `Entwurf`, `Fertig`, `Überarbeiten`) → Bestätigen

### Nach Tag filtern

Klick auf einen Tag-Chip im Bibliotheks-Header.
Nur Dokumente mit diesem Tag werden angezeigt.

### Tag entfernen

Rechtsklick → "Tags bearbeiten" → Tag löschen

---

# Teil 5 — Vorlagen

## Vorlagen auswählen und anwenden

> **Lernziel:** Du wählst die passende Vorlage für dein Dokument und passt sie an.

Vorlagen bestimmen das **Aussehen deines PDFs**: Schriftart, Ränder, Deckblatt, Kopfzeile.
Der Text im Editor bleibt immer gleich — nur die Darstellung ändert sich.

### Vorlage wählen

1. Toolbar → Vorlage-Icon (📄) — *oder* Tab "Gestalten" rechts
2. Vorlage aus der Liste auswählen
3. "Anwenden" klicken

Die Vorschau aktualisiert sich sofort.

### Eingebaute Vorlagen

JZ Writer enthält über 30 Vorlagen in acht Kategorien. Die Reihenfolge im Picker richtet sich nach deiner Rolle — Autoren sehen Kreatives Schreiben zuerst, Studierende und Dozenten sehen Hochschulvorlagen oben.

**Allgemein** *(kostenlos während Trial)*

| Vorlage | Verwendung |
|---------|-----------|
| Akademische Arbeit | Allgemeine wissenschaftliche Texte |
| Geschäftsbericht | Unternehmensberichte |
| Formeller Brief | Geschäftsbriefe |
| Lebenslauf | CV und Bewerbungen |
| Manuskript | Buchmanuskripte (Standard) |
| Minimal | Schlichter, ablenkungsfreier Stil |
| DIN-Brief | DIN-5008-konformer Brief |

**Kreatives Schreiben** *(JZ Writer Pro)*

| Vorlage | Verwendung |
|---------|-----------|
| Exposé | Projektbeschreibungen für Verlage |
| Synopse | Kurzfassung für Verlagsabgaben |
| Romankapitel | Kapitelweises Schreiben |
| Kurzgeschichte | Literarische Kurzprosa |

**Self-Publishing** *(JZ Writer Pro)*

| Vorlage | Standard |
|---------|---------|
| Amazon KDP 6×9 | Taschenbuch-Standard USA |
| BoD A5 | Books on Demand, europäisches Format |
| Kindle E-Book | Digitale Buchveröffentlichung |

**Deutsche Hochschulen** *(JZ Writer Academic)*

| Vorlage | Hochschule |
|---------|-----------|
| Deutsche Hausarbeit | Allgemeiner DE-Standard |
| LMU Hausarbeit | Ludwig-Maximilians-Universität München |
| FU Berlin | Freie Universität Berlin |

**UK / US Universities** *(JZ Writer Academic)*

Oxford · Cambridge · UCL · Harvard · MIT · Chicago

**Deutsche / UK / US Verlage** *(JZ Writer Academic)*

Springer LNCS · De Gruyter · Nature · OUP · Elsevier · Wiley · O'Reilly

**Gesperrte Vorlagen** zeigen im Picker einen grünen Hinweis: *"Verfügbar in JZ Writer Academic"* oder *"Verfügbar in JZ Writer Pro"*. Die Vorschau ist immer sichtbar — nur das Anwenden erfordert das passende Tier.

> **Ausführliche Vorlagenanleitung:** Eine vollständige Beschreibung aller Vorlagenkategorien, des Template-Editors und des Exports als `.jztemplate` findest du in `JZ-Writer-Vorlagen-Anleitung.md`.

### Eigene Vorlage erstellen

1. Vorlage-Icon → "Neue Vorlage…" (ganz unten im Picker)
2. **Deckblatt-Tab:** Name, Logo, Titelseiten-Stil
3. **Schrift-Tab:** Font, Größe, Zeilenabstand, Farben, Überschriften H1/H2/H3
4. **Seite-Tab:** Papierformat, Ränder, Seitenzahlen, Kopf-/Fußzeile
5. **Blöcke-Tab:** Info-, Warn-, Zitat- und Code-Block-Stile
6. "Done" → eigene Vorlage erscheint unter "Meine Vorlagen"

Die Live-Vorschau auf der rechten Seite aktualisiert sich bei jeder Einstellungsänderung sofort.

---

# Teil 6 — PDF-Export und Inhaltsverzeichnis

## PDF exportieren

> **Lernziel:** Du exportierst ein druckfertiges PDF mit Deckblatt und Inhaltsverzeichnis.

### Einfacher Export

**Tab "Veröffentlichen"** (rechte Spalte) → "PDF exportieren" → Speicherort wählen

*oder*

`⌘E` → PDF → Speichern

### Inhaltsverzeichnis automatisch einfügen

Zwei Methoden — beide erzeugen dasselbe Ergebnis:

**Methode 1 — Frontmatter (empfohlen):**
```
---
toc: ja
---
```
Das Inhaltsverzeichnis erscheint automatisch nach dem Deckblatt.

**Methode 2 — Platzhalter im Text:**
```
[TOC]
```
*oder*
```
[Inhaltsverzeichnis]
```
Das Inhaltsverzeichnis erscheint an der Stelle des Platzhalters.

### Überschriften nummerieren

```
---
nummerierung: ja
---
```
Überschriften werden zu `1.`, `1.1.`, `1.1.1.` usw.

---

## Bildunterschriften und Abbildungsverzeichnis

> **Lernziel:** Du fügst Bildunterschriften ein und erzeugst ein automatisches Abbildungsverzeichnis.

### Bildunterschrift

Der **Alternativtext** eines Bildes doppelt als Bildunterschrift. Ist er nicht leer, erscheint das Bild im PDF als nummerierte Abbildung:

```
![Abb. 1: Schematische Darstellung des Prozesses](local:schema.png)
```

Das Bild erhält automatisch die nächste Abbildungsnummer und die Unterschrift `Abbildung 1: Schematische Darstellung …`.

### Abbildungsverzeichnis

**Methode 1 — Frontmatter (empfohlen):**
```
---
lof: ja
---
```
Das Abbildungsverzeichnis erscheint automatisch nach dem Inhaltsverzeichnis.

**Methode 2 — Platzhalter im Text:**
```
[Abbildungsverzeichnis]
```
Das Verzeichnis erscheint an der Stelle des Platzhalters.

---

## Tabellenunterschriften und Tabellenverzeichnis

> **Lernziel:** Du versiehst Tabellen mit Unterschriften und erzeugst ein automatisches Tabellenverzeichnis.

### Tabellenunterschrift

Eine Zeile unmittelbar (ohne Leerzeile) nach der letzten Tabellenzeile, die mit `Tabelle:` beginnt, wird zur nummerierten Tabellenunterschrift:

```
| Messgröße | Wert  | Einheit |
|-----------|-------|---------|
| Spannung  | 3,3   | V       |
| Strom     | 0,5   | A       |
Tabelle: Elektrische Kennwerte des Prototyps
```

Die Tabelle erhält automatisch die nächste Tabellennummer.

### Tabellenverzeichnis

**Methode 1 — Frontmatter (empfohlen):**
```
---
lot: ja
---
```
Das Tabellenverzeichnis erscheint automatisch nach dem Inhaltsverzeichnis (bzw. nach dem Abbildungsverzeichnis, falls auch `lof: ja` gesetzt ist).

**Methode 2 — Platzhalter im Text:**
```
[Tabellenverzeichnis]
```

> **Hinweis für wissenschaftliche Arbeiten:** Setze `toc: ja`, `lof: ja` und `lot: ja` gleichzeitig — JZ Writer erzeugt dann Inhalts-, Abbildungs- und Tabellenverzeichnis automatisch in der richtigen Reihenfolge.

---

# Teil 7 — Alle Exportformate

## DOCX, EPUB, RTF und Druck

> **Lernziel:** Du exportierst in alle verfügbaren Formate und weißt, wofür jedes geeignet ist.

### Word-Dokument (.docx)

**Verwendung:** Lektorat, Zusammenarbeit mit Word-Nutzern, Verlagsabgaben

**Export:**
Tab "Veröffentlichen" → "Word (.docx) exportieren"

**Was übertragen wird:** Überschriften H1–H6, Fett, Kursiv, Listen, Tabellen, Fußnoten, Code-Blöcke, Blockzitate

**Was nicht übertragen wird:** Deckblatt-Layout, Seitenränder der Vorlage, individuelle Schriftarten

### EPUB

**Verwendung:** E-Book-Vertrieb, digitale Verlagsabgaben, Apple Books

**Export:**
Tab "Veröffentlichen" → "EPUB exportieren"

Kapitel entstehen aus Überschriften der ersten Ebene (`# Kapitel`).
Die Navigation im E-Book-Reader basiert auf deinen Überschriften.

**Gruppen-EPUB:** Rechtsklick auf eine Gruppe → "Als EPUB exportieren"
Alle Dokumente der Gruppe werden zu einem einzigen E-Book zusammengeführt.

### RTF

**Verwendung:** Legacy-Systeme, Kompatibilität mit alten Textprogrammen

**Export:**
Tab "Veröffentlichen" → "RTF exportieren"

### Drucken

**Tastaturkürzel:** `⌘P`  
**Menü:** Ablage → Drucken

Der macOS-Druckdialog öffnet sich mit einer Seitenvorschau.
Du kannst direkt aus dem Druckdialog als PDF speichern.

---

# Teil 8 — Schreibziele

## Tages- und Dokumentziele setzen

> **Lernziel:** Du setzt messbare Schreibziele und verfolgst deinen Fortschritt täglich.

### Tages-Schreibziel

Das Tagesziel zählt **alle** Wörter, die du heute in JZ Writer geschrieben hast — über alle Dokumente hinweg.

**Ziel setzen:**
Statusleiste (unten) → Ziel-Icon → Tagesziel eingeben, z. B. `500`

Der Fortschrittsbalken in der Statusleiste zeigt deinen Fortschritt: `247 / 500`.

### Dokumentziel

Das Dokumentziel gilt nur für das aktuell geöffnete Dokument.

**Ziel setzen:**
Statusleiste → Wortanzahl-Pill klicken → Ziel eingeben, z. B. `80000` (Roman)

Ein Fortschrittsbalken erscheint unter dem Dokumenttitel.
Der Balken pulsiert sanft, solange du aktiv schreibst.

### Meilenstein-Feier

Wenn du 500, 1.000, 5.000, 10.000 oder 50.000 Wörter erreichst, erscheint kurz ein Glückwunsch-Banner.
Meilensteine werden nur einmal angezeigt.

### Schreibtempo

Nach einer aktiven Schreibsession erscheint in der Statusleiste:
`⚡ 342/h` — das ist dein Durchschnitt in Wörtern pro Stunde.

### Streaks

Wenn du täglich schreibst und dein Tagesziel erreichst, wächst dein Streak-Counter.
Nur wachsende Streaks werden angezeigt. Verpasste Tage werden nicht angezeigt.

---

# Teil 9 — Lesbarkeitsanalyse

## Flesch-Amstad-Score verstehen

> **Lernziel:** Du bewertest die Lesbarkeit deines Textes und verbesserst ihn gezielt.

### Lesbarkeitsanalyse aktivieren

`⌘,` → Bereich "Schreiben" → "Lesbarkeitsanalyse anzeigen" aktivieren

Die Analyse erscheint ab **30 Wörtern** im Dokument.

### Den Score lesen

Klick auf den Lesbarkeits-Pill in der Statusleiste.

Ein Popover öffnet sich mit:
- **Arc-Skala** (0–100): Position deines Textes
- **Bedeutungstext**: Einschätzung des Niveaus
- **Tipp**: Konkreter Verbesserungshinweis

**Orientierungswerte:**

| Score | Niveau | Geeignet für |
|-------|--------|-------------|
| 70–100 | Sehr leicht | Kinder, Einsteiger |
| 60–70 | Leicht | Allgemeinpublikum |
| 50–60 | Mittel | Gebildete Laien |
| 30–50 | Schwer | Akademiker |
| 0–30 | Sehr schwer | Experten, Fachpublikum |

**Für akademische Texte** ist ein Score von 30–50 normal und angemessen.

### Lesbarkeit verbessern

- Kurze Sätze erhöhen den Score
- Häufige Wörter erhöhen den Score
- Passive Konstruktionen senken den Score
- Schachtelsätze senken den Score

---

# Teil 10 — Ultradian-Timer

## Konzentriert in Blöcken schreiben

> **Lernziel:** Du arbeitest in produktiven 25-Minuten-Blöcken und pausierst bewusst.

### Timer aktivieren

`⌘,` → Bereich "Schreiben" → "Ultradian-Timer (25 + 5 Min)" aktivieren

### So funktioniert der Timer

1. Du schreibst — der Timer zählt deine aktive Schreibzeit
2. Nach **25 Minuten**: Pause-Toast erscheint ("Zeit für eine kurze Pause")
3. Du pausierst **5 Minuten**
4. Neue Runde beginnt automatisch

**Wichtig:** Der Timer **pausiert automatisch**, wenn du aufhörst zu tippen.
Er läuft nur während aktiver Eingabe.

---

# Teil 11 — Snapshots (Versionsverlauf)

## Versionen sichern und wiederherstellen

> **Lernziel:** Du sicherst wichtige Dokumentstände als Snapshots und kannst jederzeit zu einer früheren Version zurückkehren.

### Snapshot erstellen

**Toolbar** → Snapshot-Icon (Uhr mit Pfeil)  
*oder* Rechtsklick auf Dokument → "Snapshot erstellen"

Optional: Einen beschreibenden Namen eingeben, z. B. `Version nach Lektorat`.

**Automatische Snapshots:** Alle 5 Minuten aktiven Schreibens wird automatisch ein Snapshot angelegt.

### Snapshot ansehen

Toolbar → Snapshot-Icon → Liste öffnet sich

Jeder Eintrag zeigt:
- Timestamp (Datum und Uhrzeit)
- Optionales Label
- Wortanzahl des Snapshots

### Snapshot vergleichen (Diff)

Snapshot antippen → Vorschau öffnet sich

Oben in der Vorschau gibt es einen Segmented Control mit drei Modi:

- **Vollansicht:** zeigt den Snapshot-Text unverändert
- **Vergleich:** zeigt einen vollständigen Zeilenvergleich mit dem aktuellen Dokumentinhalt
  - Zeilen in `− Rot`: im Snapshot vorhanden, im aktuellen Dokument nicht mehr
  - Zeilen in `+ Grün`: im aktuellen Dokument neu, im Snapshot noch nicht vorhanden
  - Wortgenaue Hervorhebung: veränderte Wörter innerhalb einer Zeile werden gesondert markiert
- **Nur Änderungen:** zeigt ausschließlich die geänderten Bereiche; unveränderte Abschnitte werden zu „··· N unveränderte Zeilen" zusammengefasst — ideal für große Dokumente

### Snapshot nachträglich benennen

Snapshots können auch nach der Erstellung noch benannt werden:

- **iOS:** Snapshot nach links swipen → "Benennen"
- **macOS:** Rechtsklick → "Benennen…"

Ein Dialog erscheint — Namen eingeben, "Speichern" tippen. Der Name ersetzt ab sofort das Datum als Anzeige in der Liste.

### Snapshot wiederherstellen

Snapshot auswählen → "Wiederherstellen"

Der aktuelle Dokumentinhalt wird durch den Snapshot-Inhalt ersetzt.

**Sicherheitsnetz:** Vor jeder Wiederherstellung legt JZ Writer automatisch einen Snapshot des aktuellen Stands an — mit dem Label "Vor Wiederherstellung (HH:MM)". Du kannst also jederzeit wieder zurück, ohne vorher manuell speichern zu müssen.

### Snapshot löschen

Snapshot in der Liste → Swipe oder Rechtsklick → "Löschen"

Snapshots liegen im Ordner `.jzw_snapshots` im Vault.
Sie sind normale Markdown-Dateien und können extern gesichert werden.

---

# Teil 12 — Korkwand

## Szenen und Kapitel visuell anordnen

> **Lernziel:** Du nutzt die Korkwand, um die Struktur eines Projekts zu überblicken und Szenen umzuordnen.

### Korkwand öffnen

Rechtsklick auf eine **Gruppe** in der Sidebar → "Korkwand"

Jedes Dokument der Gruppe erscheint als Karteikarte.
Die Karten zeigen Titel, Synopsis und Wortanzahl.

### Reihenfolge ändern

Karte per Drag & Drop auf eine andere Karte ziehen.
Die neue Reihenfolge wird sofort gespeichert.

### Dokument öffnen

Doppelklick auf eine Karte — oder Rechtsklick → "Im Editor öffnen"

### Subplot-Filter

Wenn Dokumente `#subplot-tag` in ihrer Synopsis haben, erscheinen Filter-Chips oben.
Klick auf einen Chip zeigt nur Karten des gewählten Subplots.

### Karteikarten im Dark Mode

Die Karteikarten bleiben absichtlich **papier-weiß** — auch im Dark Mode.
Das ist ein bewusstes Designentscheidung für maximale Lesbarkeit.

---

# Teil 13 — Zitationen und Literaturverzeichnis

## Wissenschaftlich zitieren

> **Lernziel:** Du fügst Zitate ein, verwaltest deine Bibliographie und exportierst ein korrektes Literaturverzeichnis.

### Bibliographie-Einträge anlegen

**Toolbar → Bibliographie** (Buch-Icon)

Bibliographieeinträge werden im BibTeX-Format eingegeben:

```bibtex
@book{müller2024,
  author    = {Müller, Karl},
  title     = {Einführung in die Quantenphysik},
  year      = {2024},
  publisher = {Springer},
  address   = {Berlin}
}

@article{schmidt2023,
  author  = {Schmidt, Anna and Weber, Thomas},
  title   = {Neue Erkenntnisse zur Dunklen Materie},
  year    = {2023},
  journal = {Physikalische Zeitschrift},
  volume  = {42},
  pages   = {101--115}
}
```

### Zitat im Text einfügen

**Toolbar → Zitat-Picker** (Anführungszeichen-Icon)

*oder* direkt im Text tippen:

```
Wie [@müller2024] zeigt, gilt Gleichung 3.
Mehrere Quellen belegen dies [@müller2024; @schmidt2023].
```

Im PDF erscheint: `[Müller, 2024]` (je nach Vorlage auch `(Müller 2024)`)

### Literaturverzeichnis einfügen

Am Ende des Dokuments:

```
[Literaturverzeichnis]
```

*oder*

```
[bibliography]
```

Das vollständige Literaturverzeichnis erscheint im PDF an dieser Stelle.

### Zotero-Integration

Wenn du Zotero nutzt, kannst du direkt aus deiner Zotero-Bibliothek suchen.

**Einrichten:**
1. `⌘,` → Bereich "Zotero"
2. API-Schlüssel von `zotero.org/settings/keys` eingeben
3. "Verbindung testen" → "Verbunden" erscheint

**Zitat suchen:**
Toolbar → Zitat-Picker → Tab "Zotero" → Suchbegriff eingeben → Eintrag auswählen → "Einfügen"

Der BibTeX-Eintrag wird automatisch in die Bibliographie des Dokuments eingefügt.

---

# Teil 14 — Fokus-Modus

## Ablenkungsfrei schreiben

> **Lernziel:** Du arbeitest im Fokus-Modus ohne jede visuelle Ablenkung.

### Fokus-Modus aktivieren

**Toolbar** → Fokus-Icon (Vollbild-Pfeil)  
*oder* `⌘⇧F`

Der Fokus-Modus blendet alle Elemente außer dem Textbereich aus.
Nur Titelfeld, Text und Cursor sind sichtbar.

### Fokus-Modus beenden

`Esc` — *oder* erneut `⌘⇧F`

---

# Teil 15 — Ambient Sounds

## Schreibatmosphäre mit Hintergrundgeräuschen

> **Lernziel:** Du aktivierst Hintergrundgeräusche, die deine Konzentration fördern.

### Aktivieren

`⌘,` → Bereich "Ambient Sounds" → Toggle aktivieren

### Klänge auswählen

| Klang | Wirkung |
|-------|---------|
| **Café** | Hintergrundrauschen, soziale Atmosphäre |
| **Regen** | Beruhigend, ablenkungsarm |
| **Wald** | Natur, fokussierend |
| **Schreibmaschine** | Mechanisches Klicken bei jedem Tastendruck |
| **Weißes Rauschen** | Maskiert Umgebungsgeräusche |
| **Binaural Gamma** | Kognitive Stimulation *(nur mit Kopfhörern!)* |
| **Binaural Alpha** | Entspannung, Kreativität *(nur mit Kopfhörern!)* |

Alle Klänge werden **generativ erzeugt** — keine Audiodateien, keine Lizenzpflicht.

### Lautstärke

Der Lautstärke-Slider erscheint direkt unter der Klang-Auswahl.

---

# Teil 16 — KI-Panel

## KI-gestützte Schreibhilfe

> **Lernziel:** Du nutzt das KI-Panel für Überarbeitungsvorschläge, Zusammenfassungen und Brainstorming.

### KI-Panel öffnen

Text im Editor auswählen → Toolbar → KI-Icon  
*oder* `⌘K`

### Voraussetzungen

Das KI-Panel verwendet **Apple Intelligence** (wenn verfügbar) oder den **Claude API-Schlüssel**.

**Claude API-Schlüssel eintragen:**
`⌘,` → Bereich "KI / Claude API" → Schlüssel eingeben

Den Schlüssel bekommst du kostenlos unter `console.anthropic.com`.

### Mögliche Anwendungen

- **Überarbeiten:** Ausgewählten Text stilistisch verbessern lassen
- **Zusammenfassen:** Langen Abschnitt auf Kernaussagen kürzen
- **Brainstorming:** Ideen zu einem Thema generieren
- **Gegenlesen:** Logische Konsistenz prüfen
- **Übersetzen:** Abschnitte in andere Sprachen übertragen

## KI Ghost-Text

> **Lernziel:** Du verstehst, wie der KI Ghost-Text funktioniert und wie du ihn ein- oder ausschaltest.

### Was ist Ghost-Text?

Ghost-Text ist eine **unsichtbare Schreibhilfe**: Sobald du für kurze Zeit aufhörst zu tippen, erscheint eine blasse Fortsetzung des aktuellen Satzes oder Absatzes — generiert von Claude.

Du musst nichts tun. Wenn dir der Vorschlag gefällt, drücke **Tab** — er wird übernommen.
Wenn nicht, schreibe einfach weiter — der Ghost-Text verschwindet.

### Ghost-Text ist kontextsensitiv

- In Fließtext: schlägt die nächste Phrase vor
- In einer Liste: schlägt das nächste Listenelement vor
- Mitten in einem Satz: vervollständigt den Satz

### Ghost-Text aktivieren und deaktivieren

**Einstellungen** (`⌘,`) → Bereich "KI / Claude API" → Toggle **"KI Ghost-Text"**

**Standard bei der ersten Einrichtung:**
- Rolle "Autor" → Ghost-Text **eingeschaltet**
- Rolle "Student" oder "Dozent" → Ghost-Text **ausgeschaltet**

Der Standard lässt sich jederzeit in den Einstellungen ändern.

### Voraussetzungen

Ghost-Text benötigt einen **Claude API-Schlüssel** (kostenlos unter `console.anthropic.com`).

Ohne Schlüssel ist Ghost-Text inaktiv — aber alle anderen Funktionen laufen weiter.

---

# Teil 17 — Weitere Funktionen

## Dokumentgliederung

> **Lernziel:** Du navigierst in langen Dokumenten effizient über die Gliederungsansicht.

### Gliederung öffnen

Toolbar → Listen-Icon  
*oder* Rechtsklick auf Dokument → "Gliederung"

Alle Überschriften des Dokuments werden hierarchisch angezeigt.
Klick auf eine Überschrift springt direkt zur entsprechenden Stelle.

---

## Kommentare anzeigen

### Kommentarleiste öffnen

Toolbar → Kommentar-Icon

Alle `{{...}}`-Kommentare des Dokuments werden gesammelt angezeigt.
So behältst du offene Punkte im Überblick.

---

## Spotlight-Suche

JZ Writer meldet alle Dokumente beim macOS-Spotlight an.

**Suche starten:** `⌘Space` → Dokumenttitel eingeben

Klick auf das Suchergebnis öffnet das Dokument direkt in JZ Writer.

---

## Quick-Capture-Overlay

Für spontane Ideen ohne Unterbrechung des aktuellen Workflows.

**Aktivieren:** `⌘0` — ein schwebender Editor erscheint über allen Fenstern

Text eingeben → `Return` oder `Esc` — der Text wird im konfigurierten Zieldokument gespeichert.

---

## Multi-Window (macOS)

Mehrere Dokumente gleichzeitig in separaten Fenstern bearbeiten.

**Neues Fenster öffnen:**
Rechtsklick auf Dokument → "In neuem Fenster öffnen"

Jedes Fenster hat seinen eigenen Editor und eigene Vorschau.

---

# Teil 18 — Einstellungen (Referenz)

> **Lernziel:** Du kennst alle Einstellungsbereiche und weißt, wo du was änderst.

Einstellungen öffnen: `⌘,`

### New Document

| Einstellung | Beschreibung |
|-------------|-------------|
| Standard-Vorlage | Vorlage für alle neuen Dokumente |

### Editor

| Einstellung | Beschreibung |
|-------------|-------------|
| Font Size | Schriftgröße: 10–28 pt |
| Line Spacing | Zeilenabstand: 1,0×–2,5× |

### Schreiben

| Einstellung | Beschreibung |
|-------------|-------------|
| Editor-Schrift | Monospace / Serif / Sans-Serif |
| Schreibmaschinen-Modus | Cursor immer in der Mitte |
| Lesbarkeitsanalyse | Flesch-Amstad-Badge in Statusleiste |
| Ultradian-Timer | 25+5-Minuten-Schreibblöcke |

### Ambient Sounds

| Einstellung | Beschreibung |
|-------------|-------------|
| Hintergrundgeräusche | On/Off |
| Klang | Auswahl des Klangs |
| Lautstärke | 5–100 % |

### Zotero

| Einstellung | Beschreibung |
|-------------|-------------|
| API-Schlüssel | Schlüssel für Zotero-Bibliothek |
| Verbindung testen | Verbindung zum Zotero-Server prüfen |

### KI / Claude API

| Einstellung | Beschreibung |
|-------------|-------------|
| Claude API-Schlüssel | Schlüssel für KI-Panel und Ghost-Text |
| KI Ghost-Text | Ghost-Text im Editor ein-/ausschalten (Standard nach Rolle) |

### Vault (Speicherort)

| Einstellung | Beschreibung |
|-------------|-------------|
| Aktueller Ordner | Zeigt den Pfad des aktiven Vaults |
| Ordner wechseln … | Neuen Vault auswählen |
| Im Finder zeigen | Vault im Finder öffnen |

### iCloud

Zeigt den aktuellen iCloud-Sync-Status.
Grüner Punkt = aktiv. Grauer Punkt = nicht angemeldet.

### Datenschutz

JZ Writer erhebt **keine** personenbezogenen Daten.
Kein Tracking, keine Drittanbieter-SDKs.
Dokumente verbleiben ausschließlich auf deinem Gerät und iCloud.

### Dokumentation

| Aktion | Beschreibung |
|--------|-------------|
| Handbuch wiederherstellen | 9-Kapitel-Handbuch in der Bibliothek anlegen |
| Vorlagen-Handbuch | 5-Kapitel-Vorlagenhandbuch anlegen |

---

# Teil 19 — Tastaturkürzel (Referenz)

> **Lernziel:** Du arbeitest ohne Maus effizienter mit JZ Writer.

### Allgemein

| Kürzel | Aktion |
|--------|--------|
| `⌘N` | Neues Dokument |
| `⌘⇧N` | Neue Gruppe |
| `⌘,` | Einstellungen öffnen |
| `⌘W` | Fenster schließen |
| `⌘Q` | App beenden |
| `⌘⇧O` | Vault-Ordner öffnen … |

### Editor

| Kürzel | Aktion |
|--------|--------|
| `⌘B` | Fett |
| `⌘I` | Kursiv |
| `⌘Z` | Rückgängig |
| `⌘⇧Z` | Wiederholen |
| `⌘F` | Suchen |
| `⌘K` | KI-Panel öffnen |

### Ansicht und Navigation

| Kürzel | Aktion |
|--------|--------|
| `⌘⇧F` | Fokus-Modus ein/aus |
| `⌘0` | Quick-Capture-Overlay |
| `⌘E` | Exportieren |
| `⌘P` | Drucken |

---

# Teil 20 — Häufige Fragen

## FAQ

> **Lernziel:** Du findest schnell Antworten auf häufige Fragen.

---

**Wo werden meine Dokumente gespeichert?**

In dem Ordner, den du als Vault ausgewählt hast.
`Einstellungen → Vault (Speicherort)` zeigt den genauen Pfad.
Die Dateien sind normale `.md`-Textdateien.

---

**Ich habe versehentlich ein Dokument gelöscht. Was tun?**

1. Prüfe, ob ein **Snapshot** existiert: Toolbar → Snapshot-Icon
2. Prüfe deinen **iCloud-Papierkorb** oder **Time Machine**
3. Der Vault-Ordner im Finder enthält alle Dateien — wiederherstellbar über Finder-Rückgängig (`⌘Z`)

---

**Meine PDF-Vorschau zeigt Kästchen statt Emoji.**

Das liegt daran, dass Standard-Typst-Fonts keine Farbemoji enthalten.
JZ Writer wandelt **55+ häufige Emoji** automatisch in PDF-kompatible Textsymbole um.

Wenn ein Emoji dennoch als Kästchen erscheint: Ersetze es durch ein BMP-Symbol:
`✓` `✗` `△` `→` `★` — diese funktionieren immer.

---

**Wie exportiere ich alle Kapitel eines Romans als eine PDF-Datei?**

1. Alle Kapitel in eine **Gruppe** packen
2. Rechtsklick auf die Gruppe → "Als PDF exportieren"
   *oder* → "Als EPUB exportieren"

Alle Dokumente der Gruppe werden in der Sidebar-Reihenfolge zusammengeführt.

---

**Das Inhaltsverzeichnis erscheint nicht im PDF.**

Prüfe, ob `toc: ja` im Frontmatter steht:
```
---
toc: ja
---
```
Der Frontmatter muss die **erste Zeile** des Dokuments sein — kein Leerzeichen davor.

---

**Kann ich JZ Writer mit anderen Editoren kombinieren?**

Ja. Alle Dokumente sind `.md`-Dateien.
Du kannst sie in BBEdit, Obsidian, VS Code oder jedem anderen Editor öffnen.
Änderungen werden von JZ Writer automatisch erkannt und in der Sidebar aktualisiert.

---

**Wie importiere ich eine bestehende `.md`-Datei?**

Einfach die Datei in den Vault-Ordner kopieren.
JZ Writer erkennt sie sofort und zeigt sie in der Sidebar an.
Alternativ: **Ablage → Vault neu laden** erzwingt eine sofortige Aktualisierung.

---

**Funktioniert JZ Writer ohne Internet?**

Vollständig. Alle Kernfunktionen — Editor, Export, Vorlagen, Snapshots — funktionieren offline.
Nur Zotero-Suche und Claude KI benötigen eine Verbindung.

---

**Was ist der Unterschied zwischen JZ Writer Academic und Pro?**

JZ Writer hat drei Stufen:

| Tier | Preis | Was ist enthalten |
|------|-------|------------------|
| **Free** | Kostenlos (7 Tage Trial) | Bis zu 5 Dokumente, allgemeine Vorlagen, PDF-Export |
| **Academic** | Einmalkauf (dauerhaft) | Alles Free + Hochschulvorlagen, Verlags-Templates, DOCX-Export, Zitate, KI-Panel |
| **Pro** | Einmalkauf (dauerhaft) | Alles Academic + Corkboard, Timeline, EPUB, Kreatives Schreiben, Self-Publishing-Vorlagen |

Feature-Pakete (Diagramm-Pack, Erweiterte Exporte, Tech Pack) erscheinen mit JZ Writer 1.1 als separate Zusatzkäufe.

---

**Was passiert, wenn der 7-Tage-Trial abläuft?**

Direkt nach dem Ablauf erscheint einmalig die **Testzeitraum-Info** — sie erklärt deine Optionen passend zu deiner Schreiberrolle (Student, Autor, Dozent) und zeigt die Preise.

Du verlierst keinen Text. Deine Dokumente bleiben vollständig erhalten.
Im Free-Modus kannst du weiter lesen und exportieren — bis zu den Free-Grenzen.

---

**Der Ghost-Text erscheint nicht. Was tun?**

1. Prüfe: Einstellungen → KI / Claude API → Toggle "KI Ghost-Text" muss **an** sein
2. Prüfe: Ein gültiger Claude API-Schlüssel ist eingetragen
3. Tippe etwas und warte dann mindestens 3–4 Sekunden ohne weiterzutippen
4. Ghost-Text erscheint nur in leeren Zeilen oder am Ende von Sätzen — nicht mitten im Wort

---

# Anhang — Markdown-Referenz

Eine vollständige Übersicht aller Markdown-Befehle und ihrer Typst-Ausgabe findest du im Dokument:

**JZ-Writer-Cheat-Sheet** (im Vault oder unter `~/Dokumente/JZ-Writer-Cheat-Sheet.md`)

---

*Bedienungsanleitung · JZ Writer Pre-Release 1.0 · JURZEL · August 2026*  
*Erstellt mit JZ Writer*