What's new
Find the guides for Oleafly's newest notes, Markdown, citation, editor, Typst, diagram, research, and agent features.
The newest work adds Notes, an experiment for keeping research notes as Markdown files, and lets a Markdown document build as a book, slides, a poster or a letter. Quarto web pages now show in the preview, and on a computer with no TeX the engine window offers TinyTeX first. Before that came a PDF in the project folder that stays current after every compile, the Tools on a CLI agent you already use, Zen mode, and citations from Zotero as you type. This page points to the full instructions rather than repeating a release-note list.
Research notes, as an experiment
Section titled “Research notes, as an experiment”Notes keeps research notes as Markdown files on your computer. You write them in a rich editor with callouts, tables, charts, diagrams, math, links, and tasks with due dates. It’s off until you turn on Notes in Settings → Experimentation. Notes open in tabs you can split and dock, and you find them again by search, tag, task or date. A note can live inside a project or be written with other people on a collaboration server, and the assistant or a CLI agent can suggest changes that you accept or reject in the note. Quick capture opens a small window for a thought you want to keep, from whatever app you’re in.
Turn on Notes · Write in a note · Find and arrange notes · Notes in projects and shared notes · Notes with AI
Markdown documents with a type
Section titled “Markdown documents with a type”Add type: to a Markdown document’s front matter to build it as a report, a book, slides, a poster, a letter or a CV. Slides build as 16:9 Beamer slides that Present can show, and a letter takes its addresses from to and from. Your own front matter still wins. Document type in Document settings writes the line for you, and a LaTeX export and oleafly build follow the type too.
Document types · Document settings for Markdown · Present slides
Quarto web pages in the preview
Section titled “Quarto web pages in the preview”A Quarto document that builds a web page, such as format: html or a reveal.js deck, now shows the page in the preview pane. The page can’t reach the rest of Oleafly. To open it in your own browser, choose Open in browser on the preview toolbar.
TinyTeX first when there’s no TeX
Section titled “TinyTeX first when there’s no TeX”When a project needs latexmk and this computer has no working TeX, the engine window now lists Download TinyTeX first, marked Recommended. Download and use TinyTeX installs it and compiles the project. To stay with the built-in engine, use the Keep using Tectonic card at the bottom.
When no TeX is installed · When Tectonic isn’t enough
A PDF in the project folder that stays current
Section titled “A PDF in the project folder that stays current”The save button in the PDF preview now opens a menu. Turn on Sync PDF on compiles there, and after each successful compile Oleafly refreshes a PDF named after the project title, such as Thesis_Final_Draft.pdf, in the project folder. It’s a normal file, so cloud sync and checkpoints pick it up, and Oleafly never overwrites a file it didn’t create. To get an older PDF back, open a checkpoint’s files and choose Save PDF.
Sync PDF on compiles · Save a PDF from a checkpoint
The Tools on your CLI agent
Section titled “The Tools on your CLI agent”Image to LaTeX, Image to Typst, the equation tools, and scanned PDFs can use a connected CLI agent such as Claude Code or Codex, on your own sign-in with no API key. Without a key, paper review, inline edits, and Fix with AI use that agent too. Antigravity CLI is now a built-in agent.
Use an agent instead of an API key · Agent catalog
TeX from any folder, and downloads from a mirror
Section titled “TeX from any folder, and downloads from a mirror”Choose a TeX folder in Settings → Engines → LaTeX compiles with a TeX installed where Oleafly doesn’t look. TinyTeX, Typst, and other downloads now come from Oleafly’s mirror first. Settings → Downloads → Sources can switch to the original hosts or your own mirror, and set the repository TeX packages come from. TinyTeX downloads can be cancelled and resumed.
latexmk and system TeX · Sources tab · Install and update TinyTeX
Text that goes missing from the PDF
Section titled “Text that goes missing from the PDF”TeX skips characters its font can’t show and still reports success, so a Chinese, Japanese, or Korean paragraph could come out blank. Now you get a notice, the log lists the missing characters, and it gives a setup for each script with fonts that come with the built-in engine.
Characters missing from the PDF
Local models that skip thinking
Section titled “Local models that skip thinking”Ollama and Lemonade models that think before they answer now offer None in the effort menu. Pick it for a much faster reply to a simple request.
A CJK editor font, and downloaded fonts by name
Section titled “A CJK editor font, and downloaded fonts by name”The CJK font setting gives Chinese, Japanese, and Korean characters their own font in the editor, next to your coding font. Downloaded Lato, PT Sans, and PT Serif work by name: Typst finds them, and Add to project copies one into a LaTeX project.
CJK font · Add a font to a project
Cite from Zotero while you write
Section titled “Cite from Zotero while you write”Type @ in a LaTeX, Typst, or Markdown file and your whole Zotero library shows up next to the project’s own references. Picking a paper inserts the citation and adds only that entry to the project’s .bib. Later, Add from Zotero and Update from Zotero keep the file in step with your library. It works with Zotero 7 open on the same computer, or with a zotero.org account.
Cite from your Zotero library · Connect Zotero
Editor themes and colors
Section titled “Editor themes and colors”Pick one editor theme for light mode and one for dark mode, and the editor switches with the app. Paper, a warm off-white, and One Light are new. Editor colors changes any color of a theme, with a live preview in LaTeX, Typst, and Markdown. Colors are grouped by role, so a heading, a citation, or an equation gets the same color in all three languages.
Zen mode
Section titled “Zen mode”Press Ctrl+⌘⇧F (Shift+F11 on Windows and Linux) to hide the toolbar, sidebar, assistant, and terminal. Only the editor is left, with a Compile button in the corner. Press Esc twice to bring everything back.
Paths follow renamed and moved files
Section titled “Paths follow renamed and moved files”Rename a file or drag it to another folder, and the \input, \includegraphics, #include, image(), and Markdown links that point to it change too. Oleafly asks first unless you tell it to always or never update them.
The default compile engine works for every new LaTeX project
Section titled “The default compile engine works for every new LaTeX project”The engine you pick under Settings → Engines → LaTeX now applies to new projects, imports, converted documents, and trusted folders you open in place. Choose latexmk there and new projects compile with your own TeX installation from the start.
Set a default for new projects
Zoom, fonts, and new shortcuts
Section titled “Zoom, fonts, and new shortcuts”⌘= and ⌘- zoom the whole app, ⌘, opens Settings, and ⌘⌥P shows or hides the PDF. The app and editor fonts can be any font installed on your computer. The editor also gets settings for line height, letter spacing, and the cursor’s width and color.
Appearance & themes · Keyboard shortcuts
System LaTeX and external commands
Section titled “System LaTeX and external commands”When Tectonic can’t build a document, the engine dialog opens on its own and can move the project to your system LaTeX. A banner above the editor offers Allow external commands for minted, PythonTeX, and \write18. On Linux, Oleafly now draws its own title bar and accepts files dropped from the file manager.
When Tectonic isn’t enough · Allow external commands · Install on Linux
Typst, as complete as LaTeX
Section titled “Typst, as complete as LaTeX”Typst projects now have what LaTeX projects had, and a few things of their own. Pick a Typst version per project, from 0.11 to 0.15, and Oleafly downloads it and checks it against a published checksum. Packages come from Typst Universe and can live inside the project so it compiles offline. A project’s own fonts, build variants and reproducible builds reach both Typst and the language server.
In the editor, Typst gets Visual mode, folding, sticky headings, completion for functions, paths, labels and packages, rename and Format document. It also gets the figure, table, citation and equation tools LaTeX had. Go to PDF and clicking in the PDF jump between source and page. Exports include PNG, SVG, HTML, PDF/A and PDF/UA, and Preflight checks Typst sources too.
Set up a Typst project · Write in Typst · Convert a LaTeX project to Typst
Packages, document settings and insights for every engine
Section titled “Packages, document settings and insights for every engine”Three buttons on the editor toolbar now work the same way in LaTeX, Typst and Markdown, where they apply:
- Packages searches CTAN for LaTeX, or Typst Universe for Typst, and adds the line that loads a package.
- Document settings changes paper size, margins, font, language, line spacing and numbering. It edits your preamble,
#setrules or front matter for you. - Document insights lists the figures, tables, equations, labels, citations and TODOs in a document, and copies its submission metadata.
Packages · Document settings · Document insights
One diagram composer for TikZ, Typst and Mermaid
Section titled “One diagram composer for TikZ, Typst and Mermaid”The diagram composer now asks which language the diagram is for: TikZ for LaTeX, a fletcher diagram for Typst, or a Mermaid flowchart for Markdown. All three share the same canvas, and the code and the drawing stay in step in both directions. Draw a diagram on a document’s toolbar skips the question and uses that document’s language. A Mermaid diagram inserted into Markdown also appears in the compiled PDF.
Present slides from a PDF
Section titled “Present slides from a PDF”Present any compiled PDF full screen, with an optional presenter view that shows the next slide, a timer and your notes.
Search your library like GitHub issues
Section titled “Search your library like GitHub issues”The project search on the home screen understands qualifiers such as engine:typst, is:bookmarked and created:>@today-1w, plus AND, OR, parentheses and sorting. Suggestions appear as you type, and Advanced filters edits the same text.
Zotero and alphaXiv
Section titled “Zotero and alphaXiv”Import your whole Zotero library into a project’s bibliography, and connect alphaXiv so the assistant can search and read papers from it.
CLI agents you can check and undo
Section titled “CLI agents you can check and undo”Each CLI agent in Settings shows the program Oleafly found, and Test runs it before anything is saved. After an agent changes files, you can review each change and undo or redo it. The agent home also has research starting points, such as a literature sweep or a citation audit.
Set up a CLI agent · Review and undo changes · Research starting points
Settings you can search
Section titled “Settings you can search”Type a word such as “theme”, “Zotero” or “spelling” in Settings to jump to it. A dot on a Reset button shows that something in that section differs from the default, and file paths stay blurred until you point at them.
A guide for every Oleafly Tool
Section titled “A guide for every Oleafly Tool”The optional LaTeX tools gallery now contains 47 focused tools, including ten Typst converters. You can convert documents between LaTeX, Typst, Markdown, Word, HTML, PDFs, images, spreadsheets, and Mermaid diagrams; build and validate references; search for papers, labs, and deadlines; run statistical calculations; and use small writing helpers.
Each tool now has its own page with its input, steps, example, privacy behavior, limits, and a better route when the tool is not the right fit.
Two-pane tools have a draggable, keyboard-accessible divider. Each tool remembers its desktop split, while narrow windows stack the input and result.
Proofreading that understands source files
Section titled “Proofreading that understands source files”Proofreading now combines spelling with Harper grammar and style checks in LaTeX, Typst, and Markdown. It skips source syntax that should not be treated as prose, then lets you replace a finding or ignore it for now, for one project, or everywhere. The academic profile adds checks suited to research writing, and you can disable an individual Harper rule from a finding.
Set up proofreading and academic style
Faster LaTeX editing
Section titled “Faster LaTeX editing”The editor can pair math delimiters, brackets, and environments; continue lists; close the current environment; and complete package-aware commands, references, citations, and project paths. Separate settings let you turn automatic completion, brackets, math, or environment closing on or off.
Use autocomplete and structural typing · Learn the editor
More reliable references
Section titled “More reliable references”Citation insertion follows the bibliography declared by the document, including common BibTeX and Biber setups. Library import accepts BibTeX, RIS, EndNote XML, and Zotero RDF. The reference cleaner previews normalized keys and duplicates before changing files, updates citations when keys change, and saves backups. New standalone tools cover DOI, arXiv, ISBN, PubMed, URLs, formatted citations, and eight citation styles.
Manage citations and bibliographies · Open the reference tools
Import and export across writing formats
Section titled “Import and export across writing formats”Word and HTML documents can become LaTeX, Markdown, or Typst projects. Markdown can become LaTeX or Typst, and Typst can become LaTeX or Markdown. Open projects can export their supported routes to Word, HTML with MathML, Markdown, Typst, LaTeX, plain text, PDF, source ZIP, or a page image. LaTeX presentations and books can also export to PowerPoint or EPUB. Markdown projects offer both, and Typst projects offer EPUB.
Bring in existing work · Export and convert a project
The interface in 21 languages
Section titled “The interface in 21 languages”Choose System or one of 21 languages under Settings → General → Language, from 简体中文 and 日本語 to Deutsch and Español. The interface changes immediately, without restarting. This setting controls app labels and messages. Document language, proofreading dictionaries and assistant output stay separate choices.
PDF accessibility and submission checks
Section titled “PDF accessibility and submission checks”Preflight brings compile, layout, references, assets, blind-review, ATS, and accessibility findings into one place. Its PDF/UA section checks a defined machine-testable subset, and its tagged-PDF workflow prepares compatible LaTeX projects for LuaLaTeX. The guide explains which results are definite, which are heuristic, and why a clean run is not formal PDF/UA certification.
Run Preflight and prepare a tagged PDF
TeX package recovery
Section titled “TeX package recovery”When a latexmk build reports a missing TeX file, Oleafly can find the TeX Live package that owns it, install that package, and compile again. The package manager can also search the full TeX Live catalog and shows whether a package lives in the system or personal tree.
Choose a LaTeX engine and manage packages
Easier software citation
Section titled “Easier software citation”Settings → Help & About now carries a ready-to-copy BibTeX entry for Oleafly. From an open project, Cite Oleafly in this paper can add the entry to the bibliography the document uses.
Copy or insert the Oleafly citation
Release notes and updates
Section titled “Release notes and updates”Read version-by-version changes on GitHub Releases (opens in a new tab). In the app, open Settings → Help & About to check for updates. App updates explains the update process.