mdbook-typst

Crates.iomdbook-typst
lib.rsmdbook-typst
version0.1.7
sourcesrc
created_at2023-12-01 17:04:31.5043
updated_at2024-10-29 02:07:12.723866
descriptionAn mdBook backend to output Typst markup, pdf, png, or svg
homepage
repository
max_upload_size
id1055364
size64,178
Christian Legnitto (LegNeato)

documentation

README

mdbook-typst

mdbook-typst is a backend for mdBook. The backend converts the book to Typst markup and can output any format Typst can (currently pdf, png, svg, and raw Typst markup).

Usage

First, install the Typst cli:

cargo install --git https://github.com/typst/typst

Next, install mdbook-typst (this project):

cargo install mdbook-typst

Then, add an entry to your book.toml:

[output.typst]

Finally, build your book via mdBook:

mdbook build

By default mdbook-typst will output raw Typst markup to book/typst/book.typst.

Pdf and other formats

Pdf and other formats can be output instead of raw Typst markup. In your book.toml set the format value of the output config section:

[output.typst.output]
format = "pdf"

By default mdbook-typst will output to book/typst/book.[format].

Other configuration

mdbook-typst is fairly configurable. Check out the configuration code for a complete list of options.

If you want more control, consider creating your own formatter and/or preprocessing the book using the pullup project.

Commit count: 0

cargo fmt