maquette is a Typst plugin that renders 3D models directly inside your documents: no screenshots, no external tools, no manual re-exports when you tweak the camera angle.

maquette takes STL, OBJ, and PLY files and turns them into SVG or PNG images at compile time, right inside the Typst pipeline. Point a camera, set up lighting, pick a shading model, and the result lands in your PDF. Change a parameter, recompile, done. This makes it practical to embed technical 3D illustrations in engineering reports, research papers, and documentation without maintaining a separate asset pipeline.

Everything runs as a single WASM plugin, with focus on speed.

Try it live in your browser → drag to orbit, tweak every setting, and copy the generated Typst code. It runs the exact same WASM as the plugin, fully client-side. Because your browser JIT-compiles the WASM (Typst runs it in an interpreter), the demo is dramatically faster to iterate on.

Check the documentation to see examples of all the features.

Download models to try it out: Sketchfab

Example

A back-lit Stanford bunny: a red point light placed inside the model glows through the thin ears (subsurface scattering), with the camera framed from behind. Lighting, camera and material all live in the source.

#import "@preview/maquette:0.2.0": render-obj #let bunny = read("examples/data/bunny.obj", encoding: none) #render-obj(bunny, up: (0, 1, 0), azimuth: 180, distance: 0.25, background: none, lights: ( (type: "positional", vector: (-0.1, 0.14, -0.04), color: "#ff0000", intensity: 3.0), ), sss: (intensity: 4, power: 3.5, distortion: 0.2), antialias: 3)

Gallery

Multi-view grid — front / right / top / isometric on one sheet	Per-group appearance — per-part colour, stroke & opacity from OBJ groups
Scalar color map — a math expression f(x,y,z) over a custom palette	Clipping plane — a mathematical cut opens the model to its interior