typst-book

A simple tool for creating modern online books in pure typst.

Installation (typst-book CLI)

There are multiple ways to install the typst-book CLI tool. Choose any one of the methods below that best suit your needs.

Pre-compiled binaries

Executable binaries are available for download on the GitHub Releases page. Download the binary for your platform (Windows, macOS, or Linux) and extract the archive. The archive contains an typst-book executable which you can run to build your books.

To make it easier to run, put the path to the binary into your PATH.

Build from source using Rust

To build the typst-book executable from source, you will first need to install Yarn, Rust, and Cargo. Follow the instructions on the Yarn installation page and Rust installation page. typst-book currently requires at least Rust version 1.75.

To build with precompiled artifacts, run the following commands:

cargo install --git https://github.com/Myriad-Dreamin/typst-book --locked typst-book-cli

To build from source, run the following commands:

git clone https://github.com/Myriad-Dreamin/typst-book.git
cargo run --bin typst-book-build
# optional: install it globally
cargo install --path ./cli

With global installation, to uninstall, run the command cargo uninstall typst-book.

Again, make sure to add the Cargo bin directory to your PATH.

Get started

See the Get-started online documentation.

Setup for writing your book

We don't provide a watch command, but typst-book is designated to embracing all of the approaches to writing typst documents. It's feasible to preview your documents by following approaches (like previewing normal documents):

• (Waiting for ready) once supporting local packages, you can write the book via Official Web App.

• via VSCod(e,ium), see Typst LSP and Typst Preview.

• via other editors. For example of neovim, see typst.vim and Typst Preview.

• via typst-cli watch, See typst-cli watch.

Acknowledgement

• The mdbook theme is borrowed from mdBook project.

• Compile the document with awesome Typst.