# Der Editor

Schreiben Sie LaTeX, Typst und Markdown mit Quelltext- und visueller Bearbeitung, Dokumentwerkzeugen und einem PDF neben Ihrem Entwurf.

Oleafly vereint Quelltextbearbeitung, Dokumentnavigation und PDF-Vorschau in einem Arbeitsbereich. Der CodeMirror-Editor unterstützt LaTeX, Typst und Markdown. Zeilennummern, Klammererkennung und eine Hervorhebung der aktiven Zeile sind immer aktiviert. Lange Zeilen werden umgebrochen, solange Sie **Lange Zeilen umbrechen** nicht unter **Einstellungen → Darstellung → Editor** deaktivieren.

Die Tastenkürzel unten nennen zuerst die macOS-Taste; unter Windows und Linux lesen Sie ⌘ als Ctrl.

![LLaMA in Oleafly geöffnet. Der Dateibaum steht links, der LaTeX-Quelltext in der Mitte und das kompilierte Paper rechts.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## Wählen Sie Ihren Schreibleitfaden

Jede Dokument-Engine hat ihre eigene Symbolleiste und Quelltextsyntax. Diese Leitfäden erklären jedes Steuerelement und enthalten ein Manuskript, das Sie einfügen und kompilieren können:

| Engine | Hier beginnen |
| --- | --- |
| LaTeX | [Struktur, Formatierung, Zitationen, Abbildungen, Tabellen, Formeln und Codenavigation](/docs/writing/latex/) |
| Typst | [Überschriften, Listen, Formatierung, Formeln, Abbildungen, Zitationen, Labels und Codeblöcke](/docs/writing/typst/) |
| Markdown | [Quelltext- und visuelle Bearbeitung, Pandoc-Formatierung, Verweise, Bilder und Tabellen](/docs/writing/markdown/) |

## Die Editor-Symbolleiste

Alle drei Symbolleisten verwenden dasselbe Layout:

- **Code / Visuell** steht ganz vorn und wechselt die geöffnete Datei zwischen Quelltext und [visueller Bearbeitung](#visual-editing).
- **Rückgängig** und **Wiederholen** folgen. Jede der beiden Schaltflächen ist ausgegraut, wenn es nichts Rückgängig zu Machendes oder Wiederholbares gibt.
- Die Formatierungs- und Einfügen-Schaltflächen füllen die Mitte. Schaltflächen, die nicht mehr passen, wandern bei jeder Breite in **Weitere Formatierungsoptionen** (`…`), sodass ein schmaler Editor nie ein Steuerelement verliert.
- Das rechte Ende hält die Dokumentwerkzeuge im Blick: **LaTeX-Pakete** oder **Typst-Pakete** (siehe [Pakete](/docs/packages/)), [Einblicke ins Dokument](/docs/document-insights/), [Dokumenteinstellungen](/docs/document-settings/), **Projektinfo**, **Suchen** und **Zum PDF springen**.

Markdown hat keine Paket-Schaltfläche. Diese Werkzeuge können Sie auch über die ⌘K-Palette öffnen: **LaTeX-Pakete durchsuchen**, **Typst-Pakete durchsuchen**, **Einblicke ins Dokument** und **Dokumenteinstellungen**.

## Behalten Sie Ihren Platz

Der haftende Kontext hält den umgebenden Abschnitt oder das umgebende Environment sichtbar, während Sie scrollen. In Typst-Dateien bleiben die Überschriften über dem Cursor auf dieselbe Weise angeheftet. **Haftende Kopfzeile** unter **Einstellungen → Darstellung → Editor** schaltet das aus.

Eine Brotkrumenleiste über `.tex`- und `.typ`-Dateien nennt die Datei und die Abschnitte, in denen der Cursor steht. Klicken Sie auf einen Krümnel, um zu dieser Überschrift zu springen. Die Projektgliederung hilft Ihnen, zwischen Kapiteln zu wechseln, während Referenz- und Zitationsnavigation Sie zur Quelle hinter einem Symbol führen. [Autovervollständigung](/docs/autocomplete/) umfasst paketbewusste LaTeX-Befehle, Formeleingabe und Zitationsdetails.

Jede Seitenleistenansicht merkt sich ihre Scrollposition, ihre ausgeklappten Ordner und ihre offenen Abschnitte für jedes Projekt, sodass Sie zur selben Stelle zurückkehren.

![Die App auf das dunkle Design umgestellt, danach in den Zen-Modus gewechselt, in dem nur Quelltext und PDF zu sehen sind.](https://cdn.oleafly.com/images/gifs/desktop/theme-zen.gif?v=2)

## Zen-Modus

Der Zen-Modus blendet die Projekt-Symbolleiste, die Seitenleiste, den Assistenten, das Terminal sowie die eigenen Tabs und die Formatierungsleiste des Editors aus. Übrig bleibt nur Ihr Text, und der Editor behält seine volle Breite.

Drücken Sie Ctrl+⌘⇧F unter macOS oder Shift+F11 unter Windows und Linux, um ihn einzuschalten. Sie können auch **Zen-Modus** im Menü **Layout** der Projekt-Symbolleiste oder im macOS-Menü **Ansicht** wählen oder **Zen-Modus ein- oder ausschalten** in der ⌘K-Palette ausführen. Drücken Sie dieselbe Taste erneut oder zweimal Esc, um ihn zu verlassen.

Im Zen-Modus sitzt die Schaltfläche **Kompilieren** in der oberen rechten Ecke, über dem PDF, wenn es geöffnet ist, und erscheint, wenn der Zeiger in die Nähe kommt. Ein kleines Pill-Element dort zeigt **Kompilierung läuft** während eines Builds. Nach einem fehlgeschlagenen Build steht dort **Kompilierung fehlgeschlagen**, und ein Klick darauf zeigt oder verbirgt das Kompilierprotokoll. ⌘↵ kompiliert weiterhin, und ⌘⌥P zeigt oder verbirgt das PDF, ohne den Zen-Modus zu verlassen.

Zwei Optionen liegen unter [Einstellungen → Darstellung → Projekt](/docs/settings/appearance/#zen-mode-settings). **Vollbild verwenden** füllt den Bildschirm, solange der Zen-Modus an ist. **PDF beim Kompilieren anzeigen** öffnet das PDF bei jedem Kompilieren neben dem Editor, während es verborgen ist. Die Taste selbst lässt sich unter **Einstellungen → Tastenkürzel** ändern.

## Themen, Farben und Schriftarten

Der Editor verwendet ein Thema, solange die App hell ist, und ein anderes, solange sie dunkel ist. Wählen Sie beide, ändern Sie die Farbe jedes Teils des Quelltexts und legen Sie Editor-Schriftart, Schriftgröße, Zeilenhöhe, Zeichenabstand und Cursor fest unter [Einstellungen → Darstellung → Editor](/docs/settings/appearance/#editor-themes). Eine eigene [CJK-Schrift](/docs/settings/appearance/#cjk-font) legt die Schrift für chinesische, japanische und koreanische Zeichen fest, sodass lateinischer Text in einer Programmierschrift bleiben kann. Farben folgen Rollen, die in LaTeX, Typst und Markdown dasselbe bedeuten. In LaTeX verwenden ein Abschnittsbefehl und sein Titel beide die Überschriftenfarbe, Zitationsschlüssel und Environment-Namen übernehmen die Farbe ihres Befehls, und Formeln haben eine einzige Farbe. Markdown-Zitationen wie `[@key]` und `@key` werden als Zitationen hervorgehoben, nicht als Verweise.

## Suchen und ersetzen

Drücken Sie ⌘F für ein Widget im Stil von VS Code in der oberen rechten Ecke des Editors:

- Umschalter für **Groß-/Kleinschreibung beachten** (`Aa`), **Nur ganze Wörter** (`ab`) und **Regulären Ausdruck verwenden** (`.*`)
- Ein Live-Zähler für Treffer (`3 of 41`) mit den Zuständen `No results` und `Invalid`, bei riesigen Dokumenten bei `2000+` gedeckelt
- Enter springt zum nächsten Treffer, Shift+Enter zum vorherigen, Esc schließt
- **Alle Treffer auswählen** macht aus jedem Treffer einen Cursor für gleichzeitiges Bearbeiten
- Der Chevron klappt die Zeile **Ersetzen** aus: Nächsten ersetzen, **Alle** und ein Umschalter **Groß-/Kleinschreibung beibehalten**, der die Schreibweise des ursprünglichen Tokens auf die Ersetzung überträgt (aus `figure` wird mit `image` auch `Figure` zu `Image`)

⌘A wählt die ganze Datei aus, einschließlich der aus dem Blick gescrollten Zeilen, sodass ein Kopieren oder Löschen danach alles erfasst.

## Code-Ausblendung

Klicken Sie auf den Pfeil im Bundsteg, um einzuklappen.

- In LaTeX klappt ein `\begin…\end`-Environment als ein Block ein (verschachtelungsbewusst), und ein Abschnitt klappt bis zum nächsten Abschnitt derselben oder einer höheren Ebene ein.
- In Typst klappt eine Überschrift bis zur nächsten Überschrift derselben oder höherer Ebene ein. Auch Codeblöcke in `{…}`, Inhaltsblöcke in `[…]`, Argumentlisten, Gleichungen, Raw-Blöcke und Blockkommentare klappen ein.

Klappen Sie ein Kapitel ein, während Sie an einem späteren schreiben.

## Zeilen auskommentieren

Drücken Sie ⌘/, um die aktuelle Zeile oder die markierten Zeilen zu kommentieren oder die Kommentarzeichen zu entfernen. LaTeX-Zeilen erhalten `%`, Typst-Zeilen `//`. Außerhalb des Editors öffnet dieselbe Taste die Tastenkürzel-Übersicht.

## Mehrere Cursor und Blockauswahl

Der Editor unterstützt mehrere Auswahlen: **Alt-Ziehen** für eine rechteckige (Spalten-)Auswahl und **Alle Treffer auswählen** im Such-Widget für einen Cursor pro Treffer. Jeder Cursor tippt, löscht und fügt gleichzeitig ein.

## Einrückung und Klammern

Der Editor rückt beim Tippen ein, vier Leerzeichen pro Ebene, solange Sie **Tabulatorbreite** unter **Einstellungen → Darstellung → Editor** nicht ändern. Tab rückt ein oder übernimmt den offenstehenden Autovervollständigungsvorschlag. Klammern und Anführungszeichen schließen sich automatisch, die Rückschritttaste entfernt Paare gemeinsam, und die passende Klammer wird am Cursor hervorgehoben.

## Typst-Schreibhilfen

Typst-Dateien haben einige eigene Helfer:

- Tippen Sie `$`, und das schließende `$` kommt mit. Drücken Sie Leertaste innerhalb des leeren Paares, um daraus eine abgesetzte Formel zu machen, `$ … $`. Rückschritt in einem leeren Paar entfernt beide Zeichen.
- Markieren Sie Text und tippen Sie `*`, `_`, `` ` `` oder `$`, um ihn als fetten Text, Hervorhebung, Rohtext oder Formel zu umschließen.
- In einem Listeneintrag startet Enter den nächsten Eintrag mit demselben Marker (`-`, `+`, `/` oder einer Zahl). Shift+Enter beginnt eine neue Zeile innerhalb des Eintrags, und Rückschritt direkt nach einem leeren Marker entfernt ihn. Tab stuft den Eintrag eine Ebene tiefer ein, Shift+Tab holt ihn zurück.
- Tippen Sie `/` am Zeilenanfang oder nach einem Leerzeichen, um Typst-Snippets zu öffnen: Überschrift, Abbildung, Tabellen-Abbildung, Tabelle, Gleichung, nummerierte Gleichung, Fußnote, Zitat, Code, Gliederung, Literaturverzeichnis, Seitenumbruch, Spalten, Raster, Verweis und die drei Arten von Liste.
- ⇧⌥F (Shift+Alt+F) formatiert die Datei mit typstyle. Aktivieren Sie **Beim Speichern formatieren** unter **Typst** in **Einstellungen → Darstellung → Editor**, um bei jedem ⌘S zu formatieren. Das automatische Speichern formatiert nie um.

Die `$`-Paarbildung braucht sowohl **Klammern automatisch schließen** als auch **Formeln automatisch schließen**, das Umschließen einer Auswahl braucht **Klammern automatisch schließen**. Beide Schalter liegen in **Einstellungen → Darstellung → Editor**. Die Listentasten sind immer aktiv. Vervollständigung, Umbenennen, „Zur Definition springen“ und Signaturhilfe kommen vom Typst-Sprachserver; siehe [Autovervollständigung](/docs/autocomplete/) und [Code-Intelligenz](/docs/code-intelligence/).

## Abbildungen, Tabellen und Verweise in Typst einfügen

Typst hat dieselben Einfüge-Werkzeuge wie LaTeX, und jedes schreibt Typst. Sie liegen in der Typst-Symbolleiste und im Rechtsklickmenü des Editors:

- **Abbildung einfügen** öffnet den Abbildungsdialog. Wählen Sie ein Bild aus dem Projekt oder importieren Sie eines und legen Sie dann Breite, Beschriftung, Label, Alt-Text und Platzierung fest. Steht der Cursor in einem vorhandenen `#figure`, öffnet dieselbe Schaltfläche **Abbildung bearbeiten**, sodass Sie all das ändern können.
- Fügen Sie eine Bilddatei per Einfügen oder Ziehen in den Editor ein. Oleafly speichert sie in `figures/`, wenn das Projekt diesen Ordner hat, sonst neben dem Hauptdokument, und fügt eine Abbildung ein, die sie verwendet.
- **Tabelle einfügen** fügt eine leere Tabelle in der von Ihnen gewählten Größe hinzu. **Tabelle aus CSV/XLSX…** im Rechtsklickmenü importiert eine CSV-, TSV-, Excel- oder JSON-Datei, mit optionaler Beschriftung und Label. Schalten Sie **Mit der Datendatei verknüpft lassen** ein, und Oleafly kopiert die Daten in den Ordner `data` des Projekts. Die Tabelle liest diese Datei bei jedem Kompilieren, sodass die Tabelle folgt, wenn Sie die Daten bearbeiten.
- **Aus dem Projekt zitieren** schreibt `@key` für einen Eintrag im Literaturverzeichnis des Projekts. Hat das Dokument noch kein `#bibliography`, fügt Oleafly eines hinzu.
- **Label hinzufügen** setzt ein Label auf die Überschrift, Abbildung oder Gleichung am Cursor oder wählt das Label aus, das sie bereits hat. **Querverweis einfügen** listet die Labels des Projekts und schreibt `@label`.
- Die Formel-Schaltflächen fügen Inline-Formeln, eine abgesetzte Gleichung, eine nummerierte Gleichung mit Label oder ausgerichtete Gleichungen ein. Hat das Dokument noch keine Regel zur Gleichungsnummerierung, bietet ein Hinweis **Regel hinzufügen** an.
- **Symbole** fügt jedes Symbol unter seinem Typst-Namen ein.

[In Typst schreiben](/docs/writing/typst/) behandelt jede Symbolleisten-Schaltfläche.

## Visuelle Bearbeitung

Jede LaTeX-, Typst- und Markdown-Datei hat einen **Code / Visuell**-Umschalter am Anfang ihrer Symbolleiste. Neue Projekte öffnen sich in Code, und jedes Projekt merkt sich den Modus, in dem Sie es verlassen haben. Markdown hat zusätzlich **Beides**, das Quelltext und formatierten Text übereinander oder nebeneinander zeigt.

In LaTeX und Typst ist der visuelle Modus derselbe Editor, nur mit direkt eingezeichneter Auszeichnung. Setzen Sie den Cursor in eine Überschrift, eine Gleichung oder einen Befehl, und sein Quelltext kommt in dieser Zeile zurück. Gehen Sie weiter weg, kehrt die gerenderte Form zurück. Die Datei bleibt die einzige Kopie, sodass Zeilennummern, Ausklappen, Suchen und Ersetzen, Rechtschreibprüfung und Kompilierfehler weiter funktionieren. Jede Symbolleisten-Schaltfläche schreibt denselben Quelltext, den sie im Code-Modus schreibt.

In einer Typst-Datei zeigt der visuelle Modus:

- Überschriften, fetten und hervorgehobenen Text, Rohtext, Verweise und farbigen Text
- Aufzählungs-, nummerierte und Begriffslisten mit ihren Markern
- Inline- und abgesetzte Formeln, gezeichnet von Typst
- Bilder und Abbildungen, mit der Beschriftung als reinem Text
- Tabellen als Raster, in das Sie tippen können. Wählen Sie eine Zelle aus, und eine Symbolleiste erscheint für Rahmen, Ausrichtung, Zeilen- und Spalten hinzufügen oder löschen und die Tabelle entfernen.
- Referenzen und Zitationen als Chips und Fußnoten als kleine Marker

Die Zeilen `#set`, `#show`, `#import` und `#let` oben in einer Typst-Datei klappen zu einer Leiste **Dokumenteinstellungen anzeigen** zusammen. Klicken Sie sie an, um sie an Ort und Stelle zu öffnen. Die LaTeX-Präambel klappt auf dieselbe Weise zusammen.

Der visuelle Modus eignet sich für einen Durchgang durch den Fließtext. Wechseln Sie für Struktur oder eigene Befehle zu Code. Alles, was der visuelle Modus nicht zeichnen kann, bleibt als bearbeitbarer Quelltext auf dem Bildschirm.

## Formelvorschau

Steht der Cursor in einer Gleichung, erscheint das gerenderte Ergebnis direkt darüber. KaTeX zeichnet LaTeX-Formeln, und Typst zeichnet Typst-Formeln. Das Menü der Vorschau kann sie verbergen, bis Sie die Gleichung verlassen, oder sie ganz abschalten. **Formelvorschau** unter **Einstellungen → Darstellung → Editor** schaltet sie wieder ein.

Fügen Sie LaTeX-Formeln in eine Typst-Datei ein, etwa `$\frac{a}{b}$` oder ein `equation`-Environment, und unter ihnen erscheint eine Schaltfläche **Als Typst-Formel einfügen**. Klicken Sie sie an, um das Eingefügte gegen Typst-Formeln einzutauschen, oder drücken Sie Esc, um das LaTeX zu behalten. Für Formeln, die bereits in der Datei stehen, markieren Sie sie und wählen **LaTeX-Formeln in Typst umwandeln** aus dem Rechtsklickmenü.

## Kompilierfehler im Quelltext

Nach einer fehlgeschlagenen Kompilierung wird jeder Fehler in der Datei unterstrichen, zu der er gehört. In Typst deckt die Unterstreichung exakt den Span ab, den Typst meldet, und ein Fehler, der innerhalb eines Pakets ausgelöst wird, zeigt auf die Zeile in Ihrer Datei, die ihn aufgerufen hat. Fahren Sie mit dem Zeiger über die Unterstreichung, um die Meldung zu lesen. Häufige Typst-Fehler, etwa ein unbekannter Name, eine fehlende Datei oder ein Paket oder eine nicht geschlossene Klammer, kommen mit einer klaren Erklärung, was schiefging und was Sie prüfen sollten.

Der [Protokoll-Bereich](/docs/compiling/#reading-the-logs) listet jeden Fehler mit seiner Quellzeile und den Hinweisen von Typst auf.

## Der eingebaute LaTeX-Linter

Der Editor prüft LaTeX-Dateien beim Tippen auf Strukturprobleme, vor jedem Kompilieren:

- `\end{itemize}` ohne passendes `\begin` oder unpassende Paare (`expected \end{figure}, got \end{table}`)
- Nicht geschlossene Environments
- Doppelte `\label{}`-Schlüssel
- Eine ungerade Anzahl `$` in einer Zeile (fast immer ein vergessener Formel-Begrenzer)

Fehler bekommen rote, Warnungen bernsteinfarbene Wellenlinien, mit Markern im Bundsteg. Der Linter liest nur LaTeX, deshalb stoppt er nie eine Typst- oder Markdown-Kompilierung. Kompilierfehler des tatsächlichen LaTeX-Laufs erscheinen getrennt im [Protokoll-Bereich](/docs/compiling/#reading-the-logs), und [Preflight](/docs/preflight/) fügt eigene Prüfungen auf Quelltextebene inline hinzu.

## Wortzahl

Führen Sie **Wortzahl** in der ⌘K-Palette aus, um Wörter, Zeichen und Zeilen der aktiven Datei zu zählen. Typst-Dateien werden nach den Regeln von Typst gezählt, sodass Code und Kommentare außerhalb der Summe bleiben.

## Vim- und Emacs-Tasten

Wählen Sie **Vim** oder **Emacs** unter **Tastenbelegungen** in **Einstellungen → Darstellung → Editor** oder führen Sie **Vim-Modus einschalten** in der ⌘K-Palette aus. Vim gibt Ihnen `hjkl`, Operatoren und Textobjekte (`dd`, `ciw`), `:w` und den visuellen Modus. Die Änderung greift sofort, und die Oleafly-Tastenkürzel auf dieser Seite funktionieren daneben weiter.

## Mehr als .tex

Dateien öffnen sich mit zur Dateiendung passender Hervorhebung: BibTeX, Markdown, JSON, YAML, TOML, CSS, Shell-Skripte und mehr. Bilder und PDFs öffnen sich als gerenderte Ansichten statt als Text, und Binärformate sind vor versehentlicher Beschädigung geschützt; siehe [Dateien & Ordner](/docs/files/#how-different-file-types-open).

Ändert sich eine Datei auf der Festplatte, während Sie ungespeicherte Änderungen darin haben, nennt ein Banner die Datei und bietet **Vergleichen**, **Meine Version behalten** und **Neu laden** an. LaTeX-, Typst- und Markdown-Dateien bekommen alle dasselbe Banner.

## Verwandte Seiten

- [Autovervollständigung & Slash-Befehle](/docs/autocomplete/): Vervollständigung für Befehle, Referenzen, Zitationen und das `/`-Einfügemenü
- [Code-Intelligenz](/docs/code-intelligence/): „Zur Definition springen“, Umbenennen, Hover-Karten, Formelvorschau
- [Rechtschreibung & Grammatik](/docs/spellcheck-grammar/): offline prüfendes Hunspell und Harper, das LaTeX versteht
- [Pakete](/docs/packages/), [Einblicke ins Dokument](/docs/document-insights/) und [Dokumenteinstellungen](/docs/document-settings/): die Dokumentwerkzeuge rechts in der Symbolleiste
- [Tastenkürzel](/docs/keyboard-shortcuts/): die vollständige Übersicht
- [Inline-KI-Bearbeitung](/docs/ai-inline-edit/): drücken Sie ⌘L auf einer Auswahl und beschreiben Sie die Änderung
