# Ein Projekt exportieren und konvertieren

Das neueste PDF sichern, editierbaren Quelltext verpacken, Seitenbilder oder HTML exportieren, PDF/A und PDF/UA aus Typst schreiben oder ein LaTeX-, Typst- oder Markdown-Dokument konvertieren.

Öffnen Sie **Exportieren** in der Projekt-Werkzeugleiste. Das Menü folgt der Engine und dem Typ des aktuellen Dokuments und zeigt deshalb nur Wege an, die Oleafly für dieses Projekt ausführen kann.

![Exportieren ist das Download-Steuerelement direkt nach Neu kompilieren in der oberen Projekt-Werkzeugleiste.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Wählen Sie die Ausgabe, die der Empfänger braucht

- **PDF** eignet sich zum Lesen, Drucken und für die meisten Einreichungsportale.
- **Quelltext-ZIP** ist für Mitautoren oder Systeme, die Manuskript, Abbildungen, Bibliografie und lokale Styles brauchen.
- **Seiten-PNG** ist für eine Folie, eine Nachricht oder ein Begutachtungssystem, das ein Bild erwartet.
- **PNG, SVG oder HTML aus Typst** ist für Typst-Projekte, die jede Seite als Bild, Vektorseite oder Webseite brauchen.
- **Word, HTML, Markdown, Typst, LaTeX oder reiner Text** ist für jemanden, der den Inhalt in einem anderen Format bearbeiten oder weiterverwenden will.
- **PowerPoint** wandelt eine Präsentation oder ein Markdown-Dokument in Folien um. **EPUB** ist für einen E-Book-Reader. Welche davon erscheinen, hängt von der Engine ab. Siehe [Präsentations- und Buch-Exporte](#presentation-and-book-exports).

## Ein PDF, Quelltext-Archiv oder Seitenbild speichern

1. Wählen Sie **Neu kompilieren**, damit die Ausgabe Ihre letzten Änderungen enthält.
2. Sehen Sie sich das PDF an, einschließlich der letzten Seiten und der Bibliografie.
3. Öffnen Sie **Exportieren**.
4. Wählen Sie **Als PDF exportieren**, **Quelltext exportieren (.zip)** oder **Seite als PNG exportieren**.
5. Wählen Sie im Speichern-Dialog einen Zielort.
6. Wählen Sie **Im Ordner anzeigen** in der Abschlussmeldung, um die gespeicherte Datei zu finden.

Die PDF- und Seitenbild-Aktionen bleiben deaktiviert, bis das Projekt ein PDF hat, und das Menü sagt **Für das PDF ist zuerst ein Kompilierlauf nötig**. **Als PDF exportieren** speichert das PDF, das die Vorschau zeigt. **Seite als PNG exportieren** speichert die Seite, die Sie in der Vorschau ansehen, in hoher Auflösung.

Ein Quelltext-Archiv lässt Build-Caches und Git-Interna aus. Es lässt außerdem symbolische Links aus, und die Abschlussmeldung sagt, wie viele es übersprungen hat.

### Wenn das PDF nicht aktuell ist

Oleafly speichert das PDF oder das Seitenbild auch dann, wenn die Vorschau veraltet ist, und die Abschlussmeldung sagt Ihnen das:

- Nach einer gescheiterten Kompilierung sagt sie, dass die letzte Kompilierung gescheitert ist und die Datei deshalb unvollständig sein kann.
- Nach Bearbeitungen, die Sie nicht kompiliert haben, sagt sie, dass die Datei aus der letzten Kompilierung stammt und Ihre neuesten Bearbeitungen nicht enthält.

Kompilieren Sie neu, prüfen Sie die Vorschau und exportieren Sie erneut, bevor Sie die Datei an jemanden schicken.

## Typst-Bilder und HTML

Das Export-Menü eines Typst-Projekts enthält außerdem **Bilder und HTML**, was **Mit Typst exportieren** öffnet. Typst zeichnet diese Dateien selbst, daher sehen PNG- und SVG-Seiten genau so aus wie das PDF.

- **PNG-Bilder** nutzen eine **Auflösung** von 72, 144, 300 oder 600 PPI.
- **SVG-Bilder** bewahren Seiten als Vektorgrafiken.
- **HTML** ist als **Experimentell** markiert. Typsts HTML behält Text und Bilder, lässt aber Seiteneinrichtung und Zeichnungen aus. Vor Typst 0.15 lässt es auch Formeln aus, und der Dialog sagt das, wenn Sie HTML wählen.

Bei PNG und SVG nimmt **Seiten** Seitenzahlen und Bereiche wie `1, 3-5` oder `8-` entgegen. Lassen Sie es leer für alle Seiten. Jede Seite wird als eigene Datei gespeichert, nummeriert nach dem Namen, den Sie wählen. Seitenbereiche brauchen Typst 0.12 oder neuer, HTML braucht Typst 0.13 oder neuer. Der Dialog bietet nur an, was die Typst-Version des Projekts kann. Wenn das Projekt [Build-Varianten](/docs/typst/#build-variants-and-sysinputs) hat, nutzt der Export die im Kompiliermenü ausgewählte Variante.

## PDF/A und PDF/UA aus Typst

Typst schreibt archivfähige und barrierefreie PDFs selbst. Öffnen Sie das **Schild** in der Projektleiste für [Preflight](/docs/preflight/) und finden Sie **PDF-Standards** unter der Prüfung **Barrierefreiheit**. Wählen Sie einen **Standard**, etwa PDF/A-2b oder PDF/UA-1, und wählen Sie dann **PDF exportieren**.

Die Liste hängt von der Typst-Version des Projekts ab. Typst 0.11 hat keine, Typst 0.12 bietet PDF/A-2b, Typst 0.13 ergänzt PDF/A-3b, und Typst 0.14 und neuer bieten jede PDF/A-Stufe plus PDF/UA-1. Typst 0.14 und neuer versehen außerdem jedes PDF mit Tags für Screenreader, daher gibt es kein separates Kompilieren mit Tags. PDF/UA-1 braucht einen Dokumenttitel und Alternativtext für jedes Bild, und Preflight prüft beides.

## Editierbare Formate

| Projekt-Engine | Formate im Export |
| --- | --- |
| **LaTeX** | Word, eigenständiges HTML mit MathML, Markdown, Typst und reiner Text |
| **Typst** | LaTeX, Word, eigenständiges HTML mit MathML, Markdown und reiner Text |
| **Markdown** | Word, eigenständiges HTML mit MathML, Typst, LaTeX und reiner Text |

Ein Typst-Projekt bietet außerdem EPUB an, und ein Markdown-Projekt bietet PowerPoint und EPUB an. Ein LaTeX-Projekt bietet sie nur bei einer passenden Dokumentklasse an.

Diese Konvertierungen laufen lokal über Pandoc. Oleafly nutzt eine kompatible Installation auf Ihrem Computer oder lädt beim ersten Bedarf eine geprüfte, verwaltete Version herunter.

Typst-Projekte gehen einen anderen Weg. Typst schreibt das Dokument zuerst als HTML, und Pandoc wandelt dieses HTML in Word, HTML, Markdown, LaTeX, reinen Text oder EPUB um, sodass Formeln und Referenzen ankommen. Ob ein Dokument diesen Weg nehmen kann, hängt von der Typst-Version des Projekts ab:

| Typst-Version | Weg |
| --- | --- |
| 0.15 oder neuer | Über HTML |
| 0.13 und 0.14 | Über HTML, wenn Typst das ganze Dokument schreiben kann. Wenn nicht, liest Pandoc stattdessen die Typst-Quelle. |
| 0.12 oder älter | Pandoc liest die Quelle |

Bricht Typst beim Schreiben des HTML mit einem Fehler ab, liest Pandoc bei jeder Version die Quelle. Liest Pandoc die Quelle bei Typst 0.13 oder 0.14, warnt die Abschlussmeldung, dass gedrehter, skalierter, verschobener oder geneigter Text fehlen kann, es sei denn, der Export hat Warnungen. Für den vollständigsten Export stellen Sie das Projekt im Kompiliermenü unter **Typst-Version (dieses Projekt)** auf Typst 0.15 oder neuer.

Geht der Export über HTML, bleibt Text in Layout-Funktionen wie `align`, `grid` und `rotate` erhalten. Eine mit CeTZ gemachte Zeichnung verliert ihre Linien und Formen und behält nur ihre Textbeschriftungen, und die Abschlussmeldung nennt, was Typst ausgelassen hat.

## Ein Dokument konvertieren

1. Kompilieren Sie einmal und beheben Sie Fehler im Quelltext.
2. Öffnen Sie **Exportieren** und wählen Sie das Zielformat.
3. Schließen Sie die Pandoc-Einrichtung ab, wenn Sie dazu aufgefordert werden. Sagt Oleafly, dass Pandoc nicht verfügbar ist, wählen Sie **Pandoc reparieren** unter **Einstellungen → Engines → Markdown** und exportieren Sie dann erneut.
4. Speichern Sie die konvertierte Datei mit der vorgeschlagenen Endung.
5. Lesen Sie die Abschlussmeldung. Erwähnt sie Warnungen, wählen Sie **Warnungen anzeigen**, um zu sehen, was der Export ausgelassen hat.
6. Öffnen Sie die Datei in der Ziel-Anwendung und prüfen Sie Struktur und Aussehen.

Für einen Schnelltest exportieren Sie einen kurzen Abschnitt, der eine Überschrift, eine Formel, eine Tabelle, ein Bild und eine Zitation enthält. Wenn diese fünf Elemente gut überstehen, konvertieren Sie das ganze Manuskript und sehen Sie es erneut durch.

Um ein ganzes LaTeX-Projekt in ein Typst-Projekt zu verwandeln, in dem Sie weiterarbeiten, nutzen Sie stattdessen [In ein Typst-Projekt umwandeln](/docs/typst/#convert-a-latex-project-to-typst). Es legt ein neues Projekt an und meldet, was Aufmerksamkeit braucht.

### Was die Konvertierung bewahrt

Pandoc versucht, Überschriften, Absätze, Listen, Links, Zitationen, Tabellen, Bilder und editierbare Mathematik zu bewahren. Es kann nicht jedes Merkmal der Ausgangssprache in jedem Ziel reproduzieren. Prüfen Sie diese Bereiche genau:

- eigene LaTeX-Befehle und -Umgebungen
- fein justiertes Seitenlayout oder Gleitumgebungen
- komplexe oder verschachtelte Tabellen
- Bibliografiestil und Zitationsdarstellung
- Typst-Funktionen ohne direkte Entsprechung im Ziel
- rohes HTML oder Markdown-Erweiterungen

Der HTML-Export bettet seine Ressourcen ein und schreibt Formeln als MathML. Das macht ihn nützlich, um ein Dokument zu teilen, das sich eigenständig öffnen lassen soll, aber es lohnt sich trotzdem, es in den Browsern zu testen, die Ihre Leser nutzen.

### Was jedes Format bewahrt

- Word- und PowerPoint-Exporte wandeln PDF-, SVG- und WebP-Abbildungen in PNG-Bilder mit 220 ppi um. Eine Abbildung ohne Größe im Quelltext behält ihre eigene Breite.
- HTML- und EPUB-Exporte wandeln PDF-Abbildungen in PNG-Bilder um.
- Markdown und reiner Text, aus LaTeX exportiert, behalten Titel, Autor und Zusammenfassung.
- Exporte von LaTeX nach Markdown oder Typst und von Markdown nach LaTeX oder Typst verlinken die Abbildungsdateien des Projekts, statt sie zu kopieren. Hat der Export keine Warnungen, erinnert die Abschlussmeldung Sie daran, die Bilder und die Bibliografie neben die exportierte Datei zu kopieren, bevor Sie sie kompilieren. Ein nach Typst oder LaTeX exportiertes Markdown-Dokument behält die Bibliografie, die es angibt, oder die `.bib`-Dateien des Projekts, wenn es keine angibt.
- Ein LaTeX-Export eines Markdown-Dokuments richtet sich nach seinem [Dokumenttyp](/docs/writing/markdown/#document-types). Folien und Poster werden zu Beamer-Quelltext, ein Bericht oder Buch beginnt Kapitel bei `#`-Überschriften, und ein Brief wird zu einem KOMA-Script-Brief.
- Ein LaTeX-Export aus Typst kopiert die Bilder des Dokuments in einen Ordner `<name>-media` neben der `.tex`-Datei. SVG-, GIF- und WebP-Bilder werden dort zu PDFs, weil LaTeX sie nicht lesen kann.

Exporte suchen Abbildungen im Ordner des Hauptdokuments, im Projektstamm und in allen `\graphicspath`-Ordnern, und sie finden eine Abbildung, die ohne ihre Endung benannt ist. EPS-Abbildungen lassen sich nicht umwandeln, deshalb gehen sie mit einer Warnung unverändert in die Datei. In einem Word-, HTML-, EPUB- oder PowerPoint-Export eines Markdown-Dokuments zeigt ein Mermaid-Block die dafür gespeicherte Abbildung.

### Warnungen nach einem Export

Pandoc lässt aus, was ein Format nicht fassen kann. Geschieht das bei einem Export aus einem LaTeX- oder Markdown-Projekt oder bei einem Typst-Export, der die Quelle liest, sagt die Abschlussmeldung, dass die Datei mit Warnungen gespeichert wurde und wie vielen, anstelle ihrer anderen Hinweise, etwa der Erinnerung, Bilder zu kopieren. Wählen Sie **Warnungen anzeigen**, um **Export-Warnungen** zu öffnen, das auflistet, was verloren ging. **Im Ordner anzeigen** in diesem Dialog öffnet den Ordner mit der gespeicherten Datei.

Die Liste kann nennen:

- einen Block, den der Export ausgelassen hat, mit Datei und Zeile, wenn bekannt, etwa eine `tikzpicture`, ein `\includepdf` oder einen Beamer-Overlay-Befehl wie `\only` oder `\uncover`
- eine Abbildung, die der Export nicht finden oder umwandeln konnte
- einen Zitationsschlüssel, der nicht in der Bibliografie steht
- Mathematik, die als TeX-Code stehen blieb
- Verweise ohne Nummer, die eine Kompilierung behebt

Eine wiederholte Warnung erscheint einmal, und die Liste endet bei 50. Ein PowerPoint-Export verhält sich bei einer fehlenden Abbildung anders: Er bricht ab, speichert keine Datei, und der Fehler nennt die Abbildung. Typst-Exporte, die über HTML gehen, sagen in der Abschlussmeldung, was Typst ausgelassen hat.

## Präsentations- und Buch-Exporte

Ein LaTeX-Projekt passt diese an seine Dokumentklasse an. **Als PowerPoint exportieren (.pptx)** erscheint für eine Beamer-Präsentation und **Als EPUB exportieren (.epub)** für die Klassen `book`, `report`, `memoir`, `scrbook` und `scrreprt`.

In einer Beamer-Präsentation beginnt jeder Frame eine neue Folie, `\section` fügt eine Abschnittsfolie hinzu, und `\subsection` fügt keine hinzu. Ein Frame mit mehr als einem Bild oder mit einem Bild und anderem Inhalt kann auf eine zweite Folie überlaufen.

In Typst- und Markdown-Projekten prüft das Menü das Dokument für diese Exporte nicht. Ein Markdown-Projekt bietet immer beide an, und ein Typst-Projekt bietet immer EPUB an. Wird ein Markdown-Dokument zu PowerPoint, wird jede Überschrift der Ebene 1 eine Abschnittsfolie, und jede Überschrift der Ebene 2 beginnt eine neue Folie. Eine Ausnahme ist ein Dokument mit `type: slides`: Eine Zeile `slide-level` in seinem YAML-Kopf bestimmt die Überschriftenebene, die eine Folie beginnt. Jedes EPUB erhält ein Inhaltsverzeichnis, und seine Formeln sind MathML.

Nutzen Sie diese als editierbare Ausgangspunkte. Folienaufbau und Buchtypografie lassen sich zwischen Formaten selten eins zu eins abbilden, sehen Sie sich also jede Folie und jedes Kapitel in der Ziel-Anwendung an.

## Eine eigenständige Abbildung exportieren

Ein Projekt für eine eigenständige Abbildung bietet nach dem Kompilieren **Als PDF exportieren (Vektorbild)** und **Als PNG exportieren** an. Wählen Sie PDF für scharfe Linien und Text in jeder Größe. Wählen Sie PNG, wenn das Ziel nur Rasterbilder akzeptiert.

## Ausgaben im Projekt speichern

Die [PDF-Vorschau](/docs/pdf-preview/) bietet außerdem **PDF im Projekt speichern** an. Das bewahrt eine Einreichungskopie oder eine kompilierte Abbildung neben dem Quelltext auf. Um diese Kopie aktuell zu halten, schalten Sie [PDF beim Kompilieren synchronisieren](/docs/pdf-preview/#sync-pdf-on-compiles) im selben Menü ein, und Oleafly aktualisiert nach jeder erfolgreichen Kompilierung ein nach dem Projekt benanntes PDF. Ein früheres PDF lässt sich aus einem [Checkpoint](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) speichern, ohne das Projekt wiederherzustellen. Fügen Sie diese Datei nur zur [Git-Historie](/docs/git-history/) hinzu, wenn Sie generierte Ausgaben versionieren wollen.

## Vor dem Teilen prüfen

Führen Sie [Preflight](/docs/preflight/) vor einer Einreichung aus. Wenn Sie ein PDF mit Tags brauchen, folgen Sie dem Ablauf für barrierefreie Exporte in LaTeX oder wählen Sie in einem Typst-Projekt einen PDF/UA-Standard, und prüfen Sie das Ergebnis dann mit einem unabhängigen PDF/UA-Prüfwerkzeug und einer menschlichen Prüfung der Barrierefreiheit. Preflight prüft viele nützliche Signale, zertifiziert aber keine Konformität.
