Export and convert a project
Save the latest PDF, package editable source, export page images or HTML, write PDF/A and PDF/UA from Typst, or convert a LaTeX, Typst, or Markdown document.
Open Export in the project toolbar. The menu follows the current document engine and type, so it only shows routes Oleafly can run for that project.

Pick the output your recipient needs
Section titled “Pick the output your recipient needs”- PDF is for reading, printing, and most submission portals.
- Source ZIP is for co-authors or systems that need the manuscript, figures, bibliography, and local styles.
- Page PNG is for a slide, message, or review system that expects an image.
- PNG, SVG, or HTML written by Typst is for Typst projects that need every page as an image, vector pages, or a web page.
- Word, HTML, Markdown, Typst, LaTeX, or plain text is for someone who needs to edit or reuse the content in another format.
- PowerPoint is for turning a presentation or a Markdown document into slides. EPUB is for an e-book reader. Which ones appear depends on the engine. See Presentation and book exports.
Save a PDF, source archive, or page image
Section titled “Save a PDF, source archive, or page image”- Choose Recompile so the output includes your latest edits.
- Inspect the PDF, including the final pages and bibliography.
- Open Export.
- Choose Export as PDF, Export source (.zip), or Export page as PNG.
- Pick a destination in the save dialog.
- Choose Show in folder in the completion message to find the saved file.
The PDF and page-image actions stay disabled until the project has a PDF, and the menu says PDF requires a compile first. Export as PDF saves the PDF shown in the preview. Export page as PNG saves the page you are looking at in the preview, at high resolution.
A source archive excludes build caches and Git internals. It also leaves out symbolic links, and the completion message says how many it skipped.
When the PDF isn’t current
Section titled “When the PDF isn’t current”Oleafly still saves the PDF or page image when the preview is out of date, and the completion message tells you:
- After a failed compile, it says the last compile failed, so the file may be incomplete.
- After edits you haven’t compiled, it says the file comes from the last compile and doesn’t include your latest edits.
Recompile, check the preview, and export again before you send the file to anyone.
Typst images and HTML
Section titled “Typst images and HTML”A Typst project’s Export menu also has Images and HTML, which opens Export with Typst. Typst draws these files itself, so PNG and SVG pages look exactly like the PDF.
- PNG images take a Resolution of 72, 144, 300, or 600 PPI.
- SVG images keep pages as vector graphics.
- HTML is marked Experimental. Typst’s HTML keeps text and images but leaves out page setup and drawings. Before Typst 0.15 it leaves out equations too, and the dialog says so when you pick HTML.
For PNG and SVG, Pages takes page numbers and ranges such as 1, 3-5 or 8-. Leave it empty for every page. Each page is saved as its own file, numbered after the name you pick. Page ranges need Typst 0.12 or later, and HTML needs Typst 0.13 or later. The dialog only offers what the project’s Typst version can do. If the project has build variants, the export uses the one selected in the compile menu.
PDF/A and PDF/UA from Typst
Section titled “PDF/A and PDF/UA from Typst”Typst writes archival and accessible PDFs itself. Open the shield in the project rail for Preflight, and find PDF standards under the Accessibility check. Pick a Standard, such as PDF/A-2b or PDF/UA-1, then choose Export PDF.
The list depends on the project’s Typst version. Typst 0.11 has none, Typst 0.12 offers PDF/A-2b, Typst 0.13 adds PDF/A-3b, and Typst 0.14 and later offer every PDF/A level plus PDF/UA-1. Typst 0.14 and later also tag every PDF for screen readers, so there is no separate tagged compile. PDF/UA-1 needs a document title and alternative text for every image, and Preflight checks both.
Editable formats
Section titled “Editable formats”| Project engine | Formats in Export |
|---|---|
| LaTeX | Word, self-contained HTML with MathML, Markdown, Typst, and plain text |
| Typst | LaTeX, Word, self-contained HTML with MathML, Markdown, and plain text |
| Markdown | Word, self-contained HTML with MathML, Typst, LaTeX, and plain text |
A Typst project also offers EPUB, and a Markdown project offers PowerPoint and EPUB. A LaTeX project offers them only for a matching document class.
These conversions run locally through Pandoc. Oleafly uses a compatible installation on your computer or downloads a verified managed build the first time it is needed.
Typst projects take a different route. Typst first writes the document as HTML, and Pandoc turns that HTML into Word, HTML, Markdown, LaTeX, plain text, or EPUB, so equations and references come through. Whether a document can take that route depends on the project’s Typst version:
| Typst version | Route |
|---|---|
| 0.15 or later | Through HTML |
| 0.13 and 0.14 | Through HTML when Typst can write the whole document. When it can’t, Pandoc reads the Typst source instead. |
| 0.12 or earlier | Pandoc reads the source |
If Typst stops with an error while writing the HTML, Pandoc reads the source on any version. When Pandoc reads the source on Typst 0.13 or 0.14, the completion message warns that rotated, scaled, moved, or skewed text may be missing, unless the export has warnings. For the most complete export, switch the project to Typst 0.15 or later under Typst version (this project) in the compile menu.
When the export goes through HTML, text inside layout functions such as align, grid, and rotate stays in it. A drawing made with CeTZ loses its lines and shapes and keeps only its text labels, and the completion message names what Typst left out.
Convert a document
Section titled “Convert a document”- Compile once and fix any source errors.
- Open Export and choose the target format.
- Complete Pandoc setup if prompted. If Oleafly says Pandoc isn’t available, choose Repair Pandoc in Settings → Engines → Markdown, then export again.
- Save the converted file with the suggested extension.
- Read the completion message. If it mentions warnings, choose Show warnings to see what the export left out.
- Open the file in the destination app and check its structure and appearance.
For a quick test, export a short section that contains a heading, equation, table, image, and citation. If those five elements survive well, convert the full manuscript and review it again.
To turn a whole LaTeX project into a Typst project you keep working in, use Convert to a Typst project instead. It creates a new project and reports what needs attention.
What conversion preserves
Section titled “What conversion preserves”Pandoc aims to preserve headings, paragraphs, lists, links, citations, tables, images, and editable math. It cannot reproduce every source-language feature in every target. Check these areas closely:
- custom LaTeX commands and environments
- hand-tuned page layout or floats
- complex or nested tables
- bibliography style and citation rendering
- Typst functions with no direct target equivalent
- raw HTML or Markdown extensions
HTML export embeds its resources and writes equations as MathML. That makes it useful for sharing a document that should open on its own, but it is still worth testing in the browsers your readers use.
What each format keeps
Section titled “What each format keeps”- Word and PowerPoint exports turn PDF, SVG, and WebP figures into PNG pictures at 220 ppi. A figure with no size in the source keeps its own width.
- HTML and EPUB exports turn PDF figures into PNG pictures.
- Markdown and plain text exported from LaTeX keep the title, author, and abstract.
- Exports to Markdown or Typst from LaTeX, and to LaTeX or Typst from Markdown, link to the project’s figure files instead of copying them. Unless the export has warnings, the completion message reminds you to copy the images and bibliography next to the exported file before you compile it. A Markdown document exported to Typst or LaTeX keeps the bibliography it declares, or the project’s
.bibfiles if it declares none. - A LaTeX export of a Markdown document follows its document type. Slides and posters become Beamer source, a report or book starts chapters at
#headings, and a letter becomes a KOMA-Script letter. - A LaTeX export from Typst copies the document’s images into a
<name>-mediafolder beside the.texfile. SVG, GIF, and WebP images become PDFs there, because LaTeX can’t read them.
Exports look for figures in the main document’s folder, the project root, and any \graphicspath folders, and they find a figure named without its extension. EPS figures can’t be converted, so they go into the file unchanged, with a warning. In a Word, HTML, EPUB, or PowerPoint export of a Markdown document, a Mermaid block shows the figure saved for it.
Warnings after an export
Section titled “Warnings after an export”Pandoc leaves out what a format can’t hold. When that happens in an export from a LaTeX or Markdown project, or a Typst export that reads the source, the completion message says the file was saved with warnings and how many, in place of its other notes, such as the reminder to copy images. Choose Show warnings to open Export warnings, which lists what went missing. Show in folder in that dialog opens the folder with the saved file.
The list can name:
- a block the export left out, with its file and line when known, such as a
tikzpicture, an\includepdf, or a Beamer overlay command like\onlyor\uncover - a figure the export couldn’t find or convert
- a citation key that isn’t in the bibliography
- math that stayed as TeX code
- references with no number yet, which a compile fixes
A repeated warning appears once, and the list stops at 50. A PowerPoint export works differently when a figure is missing: it stops, saves no file, and the error names the figure. Typst exports that go through HTML say what Typst left out in the completion message instead.
Presentation and book exports
Section titled “Presentation and book exports”A LaTeX project matches these to its document class. Export as PowerPoint (.pptx) appears for a Beamer presentation, and Export as EPUB (.epub) for the book, report, memoir, scrbook, and scrreprt classes.
In a Beamer deck, each frame starts a new slide, \section adds a section slide, and \subsection adds none. A frame with more than one image, or with an image and other content, can run onto a second slide.
In Typst and Markdown projects, the menu doesn’t check the document for these exports. A Markdown project always offers both, and a Typst project always offers EPUB. When a Markdown document becomes PowerPoint, each level 1 heading becomes a section slide and each level 2 heading starts a new slide. The exception is a document with type: slides: a slide-level line in its front matter picks the heading level that starts a slide. Every EPUB gets a table of contents, and its equations are MathML.
Use these as editable starting points. Slide composition and book typography rarely map one-to-one between formats, so inspect every slide or chapter in its destination app.
Export a standalone figure
Section titled “Export a standalone figure”A standalone figure project offers Export as PDF (vector image) and Export as PNG after compilation. Choose PDF for sharp lines and text at any scale. Choose PNG when the destination only accepts raster images.
Save output inside the project
Section titled “Save output inside the project”The PDF preview also offers Save PDF to project. This keeps a submission copy or compiled figure beside the source. To keep that copy current, turn on Sync PDF on compiles in the same menu, and Oleafly refreshes a PDF named after the project after each successful compile. An earlier PDF can be saved from a checkpoint without restoring the project. Add that file to Git history only when you intend to version generated output.
Check before sharing
Section titled “Check before sharing”Run Preflight before a submission. If you need a tagged PDF, follow the accessible-export workflow for LaTeX or pick a PDF/UA standard in a Typst project, then verify the result with an independent PDF/UA checker and a human accessibility review. Preflight checks many useful signals, but it does not certify conformance.