Files and images

Split a document into files

Keep the main file small and include chapters:

#set page(paper: "a4")
#include "introduction.typ"
#include "methods.typ"

Create or upload files using the Files panel. Open a file there to edit it. When you rename or move a file, update the paths that refer to it.

Paths are relative to the source file containing the reference. Match capitalization exactly, including the extension.

Add a figure

Upload your image to the project, then choose Document → Insert figure… to prepare the insertion. You can also write it directly:

#figure(
  image("images/experiment.png", width: 80%),
  caption: [The experimental setup.],
) <experiment>

See @experiment for the setup.

The example requires an uploaded images/experiment.png. Change the path to match your file.

Keep projects portable

Use project files for assets you need to preserve with the document. A project ZIP can retain those assets alongside the source. Keep reusable definitions in a package when several documents share them.

If an image does not appear, check the diagnostic, the path, and whether the upload completed. See compilation problems.