Typst
A markup-based document compiler with functions and scripting for mathematical formulas, references, templates, custom fonts and incremental PDF generation.
A programmable typesetting workflow
Typst combines readable markup with functions and scripting. A local .typ source can produce a PDF with formulas, references, templates, images and custom fonts, while watch mode provides incremental previews during editing.
Reproducibility needs the full environment
Compiler version, templates, packages and fonts all affect pagination and glyphs. Keep a versioned dependency list and a clean build step so another machine can reproduce the result.
Local compilation and hosted editing
The CLI can compile ordinary local documents without a hosted editor. Remote packages or missing fonts may require retrieval on first use, so review sources, licenses and cached versions before formal publication.
Save to your cloud drive
Open the cloud drive to get the file directly, or save it for convenient access on another device.
Quark Cloud Drive
RecommendedSave Typst to this cloud drive
Baidu Netdisk
Save Typst to this cloud drive
Typst local compilation and reproducible PDF workflow
Start with a minimal typ file, compile it to a known PDF path, then add formulas, references, templates and packages while recording the environment.
Before you start
- Prepare a project directory for source, images, references and output files.
- Record Typst 0.15.1 and the fonts required by the document, including their distribution terms.
- Pin external templates and packages before using them in a formal document.
Installation steps
- 01
Extract the Windows compiler
Verify Typst 0.15.1 and the Windows x64 archive, then place the executable in a controlled tools directory and inspect help.
- 02
Create a minimal source
Write a UTF-8 typ file with a title, paragraph and list, keeping images and references at clear relative paths.
- 03
Compile an initial PDF
Compile with explicit input and output paths, review errors and check pages, fonts, formulas and file size.
Quick start
- 01
Preview with watch
Use watch while editing to rebuild after saves, then run one clean compile for the release artifact.
- 02
Check fonts and assets
Confirm the compiler can find every required font and image; repair missing assets explicitly instead of relying on a replacement installed elsewhere.
- 03
Rebuild in a clean environment
Compile with the same compiler, packages, templates and fonts on another device or clean directory and compare pagination and references.
Usage tips
- Keep compiler, package, template and font versions with the project for repeatable output.
- Watch improves editing feedback but does not replace a clean release build and page-by-page PDF review.
- Third-party packages contain executable Typst code; review their source and pin versions before upgrades.
Troubleshooting and uninstall
Why are some characters missing?
Check the font directory and selected family for coverage, confirm the exact font name and review embedding and licensing details.
Why can a reference, image or package not be found?
Check the project root, relative path, filename case, package version and cache; avoid scattered absolute paths as a long-term fix.
- Archive the project and remove the compilerKeep typ sources, dependency notes, font inventory and final PDFs, stop watch processes and remove Typst from PATH or the tools directory.
Frequently asked questions
Can Typst compile a LaTeX file directly?
No. Typst is a separate markup and scripting language, so migration requires conversion and manual review of syntax, templates and packages.
Does the CLI require an internet connection for every PDF?
Local documents can compile offline when tools and fonts are present; remote packages or missing dependencies may require a first retrieval.
Why can the same source paginate differently on two computers?
Compiler, package, template and font versions affect line breaks and pages, so record the complete environment.
What does watch mode do?
It watches source changes and incrementally recompiles during editing; a clean compile remains useful for the release build.