Typst is a new markup-based typesetting system that is designed to be as powerful as LaTeX while being much easier to learn and use. Typst has: - Built-in markup for the most common formatting tasks - Flexible functions for everything else - A tightly integrated scripting system - Math typesetting, bibliography management, and more - Fast compile times thanks to incremental compilation - Friendly error messages in case something goes wrong This repository contains the Typst compiler and its CLI, which is everything you need to compile Typst documents locally. For the best writing experience, consider signing up to our [collaborative online editor][app] for free. It is currently in public beta. ## Example A [gentle introduction][tutorial] to Typst is available in our documentation. However, if you want to see the power of Typst encapsulated in one image, here it is:

Let's dissect what's going on: - We use _set rules_ to configure element properties like the size of pages or the numbering of headings. By setting the page height to `auto`, it scales to fit the content. Set rules accommodate the most common configurations. If you need full control, you can also use [show rules][show] to completely redefine the appearance of an element. - We insert a heading with the `= Heading` syntax. One equals sign creates a top level heading, two create a subheading and so on. Typst has more lightweight markup like this, see the [syntax] reference for a full list. - [Mathematical equations][math] are enclosed in dollar signs. By adding extra spaces around the contents of an equation, we can put it into a separate block. Multi-letter identifiers are interpreted as Typst definitions and functions unless put into quotes. This way, we don't need backslashes for things like `floor` and `sqrt`. And `phi.alt` applies the `alt` modifier to the `phi` to select a particular symbol variant. - Now, we get to some [scripting]. To input code into a Typst document, we can write a hash followed by an expression. We define two variables and a recursive function to compute the n-th fibonacci number. Then, we display the results in a center-aligned table. The table function takes its cells row-by-row. Therefore, we first pass the formulas `$F_1$` to `$F_8$` and then the computed fibonacci numbers. We apply the spreading operator (`..`) to both because they are arrays and we want to pass the arrays' items as individual arguments.

Text version of the code example.

```typst #set page(width: 10cm, height: auto) #set heading(numbering: "1.") = Fibonacci sequence The Fibonacci sequence is defined through the recurrence relation $F_n = F_(n-1) + F_(n-2)$. It can also be expressed in _closed form:_ $ F_n = round(1 / sqrt(5) phi.alt^n), quad phi.alt = (1 + sqrt(5)) / 2 $ #let count = 8 #let nums = range(1, count + 1) #let fib(n) = ( if n <= 2 { 1 } else { fib(n - 1) + fib(n - 2) } ) The first #count numbers of the sequence are: #align(center, table( columns: count, ..nums.map(n => $F_#n$), ..nums.map(n => str(fib(n))), )) ```

## Installation Typst's CLI is available from different sources: - You can get sources and pre-built binaries for the latest release of Typst from the [releases page][releases]. Download the archive for your platform and place it in a directory that is in your `PATH`. To stay up to date with future releases, you can simply run `typst update`. - You can install Typst through different package managers. Note that the versions in the package managers might lag behind the latest release. - Linux: View [Typst on Repology][repology] - macOS: `brew install typst` - Windows: `winget install --id Typst.Typst` - If you have a [Rust][rust] toolchain installed, you can also install the latest development version with `cargo install --git https://github.com/typst/typst --locked typst-cli`. Note that this will be a "nightly" version that may be broken or not yet properly documented. - Nix users can use the `typst` package with `nix-shell -p typst` or build and run the bleeding edge version with `nix run github:typst/typst -- --version`. - Docker users can run a prebuilt image with `docker run -it ghcr.io/typst/typst:latest`. ## Usage Once you have installed Typst, you can use it like this: ```sh # Creates `file.pdf` in working directory. typst compile file.typ # Creates PDF file at the desired path. typst compile path/to/source.typ path/to/output.pdf ``` You can also watch source files and automatically recompile on changes. This is faster than compiling from scratch each time because Typst has incremental compilation. ```sh # Watches source files and recompiles on changes. typst watch file.typ ``` Typst further allows you to add custom font paths for your project and list all of the fonts it discovered: ```sh # Adds additional directories to search for fonts. typst compile --font-path path/to/fonts file.typ # Lists all of the discovered fonts in the system and the given directory. typst fonts --font-path path/to/fonts # Or via environment variable (Linux syntax). TYPST_FONT_PATHS=path/to/fonts typst fonts ``` For other CLI subcommands and options, see below: ```sh # Prints available subcommands and options. typst help # Prints detailed usage of a subcommand. typst help watch ``` If you prefer an integrated IDE-like experience with autocompletion and instant preview, you can also check out the [Typst web app][app], which is currently in public beta. ## Community The main place where the community gathers is our [Discord server][discord]. Feel free to join there to ask questions, help out others, share cool things you created with Typst, or just to chat. Aside from that there are a few places where you can find things built by the community: - The official [package list](https://typst.app/docs/packages) - The [Awesome Typst](https://github.com/qjcg/awesome-typst) repository If you had a bad experience in our community, please [reach out to us][contact]. ## Contributing We would love to see contributions from the community. If you experience bugs, feel free to open an issue. If you would like to implement a new feature or bug fix, please follow the steps outlined in the [contribution guide][contributing]. To build Typst yourself, first ensure that you have the [latest stable