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

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

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.

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.71.

Since typst-book building depends on yarn, you cannot directly use cargo install to pull and build it. The build command is:

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.

See the Get-started online documentation.

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.

• The mdbook theme is borrowed from mdBook project.

• Compile the document with awesome Typst.