PaperPilot Docs

PDF Preview

Live-updating PDF preview with sync scrolling

PaperPilot compiles your LaTeX in real-time and displays the PDF right next to your editor.

Editor with PDF Preview

How It Works

Auto-Compilation

As you type, PaperPilot watches for changes and queues a compilation build.

Cloud Compilation

Your document is compiled on our servers using a full TeX Live installation.

Instant Preview

The compiled PDF streams back and updates instantly in the preview panel.

Compilation is debounced - the system waits for a pause in typing before compiling to avoid excessive builds.

Preview Controls

Zoom

Control the zoom level for comfortable reading:

ControlAction
+ / - buttonsZoom in/out by 10%
Zoom dropdownSelect preset levels (50%, 75%, 100%, etc.)
Ctrl+ScrollZoom with mouse wheel
Fit to WidthAutomatically fit page width
Fit to PageShow entire page
ControlAction
ScrollMove through pages
Page inputJump to specific page number
/ arrowsPrevious/next page
Thumbnail sidebarClick to jump (if enabled)

Sync Scrolling

The editor and preview stay synchronized:

  • Editor -> Preview: Click in the editor to scroll preview to that location
  • Preview -> Editor: Double-click in PDF to jump to source
  • Toggle: Enable/disable sync in preview settings

Sync scrolling works best with \synctex enabled (on by default). If jumps seem off, try recompiling.

Compilation Options

Compiler Selection

Choose the LaTeX engine that matches your document:

pdfLaTeX (Default)

  • Fastest compilation
  • Great for standard documents
  • Limited Unicode support
  • Standard font handling

Best for: Most academic papers, templates, quick previews

XeLaTeX

  • Full Unicode support
  • System font access
  • Slower than pdfLaTeX

Best for: Documents with non-Latin scripts, custom fonts

\usepackage{fontspec}
\setmainfont{Times New Roman}

LuaLaTeX

  • Full Unicode support
  • Lua scripting capabilities
  • System font access
  • Some unique packages require it

Best for: Complex typesetting, Lua-enhanced packages

Draft Mode

Enable draft mode for faster compilation during editing:

  • Skips images - Uses placeholders instead of loading full images
  • Faster builds - Significantly reduced compile time
  • Visual marker - "DRAFT" watermark on pages

Draft mode is great for writing. Switch to full mode before final export.

Troubleshooting

Compilation Errors

When compilation fails:

  1. Check the log - Click the error indicator to view the full log
  2. Find the line - Click on errors to jump to the source location
  3. Ask AI - The Writing Agent can diagnose and fix common errors

Common Issues

ErrorSolution
Missing packageAdd \usepackage{package} to preamble
Undefined control sequenceCheck command spelling or add required package
Missing $Add missing math delimiters
File not foundCheck image paths and file names
Overfull hboxAdjust text or use \sloppy

Preview Not Updating

If the preview seems stuck:

  1. Check for errors - Compilation might have failed silently
  2. Force refresh - Click the refresh button in preview toolbar
  3. Recompile - Press F5 to trigger manual compilation
  4. Clear cache - Use settings menu to clear compilation cache

PDF Viewer Options

Built-in Viewer

The default PDF viewer provides:

  • Fast rendering
  • Sync scrolling support
  • Text selection
  • Search within PDF

External Viewer

You can also download the PDF and open in an external viewer:

  1. Click the download button in the preview header
  2. Open with your preferred PDF reader
  3. Re-download after changes

External viewers are helpful for very long documents or when you need advanced annotation features.

Light and Dark Themes

The PDF preview respects your theme setting:

Dark Mode Preview The UI is dark but PDF content renders normally (white background).

Light Mode Preview Light interface with standard PDF appearance.

On this page