Rheo 0.4.0

What is Rheo?

The simple answer is that Rheo (ree-oh) is document infrastructure that makes Typst a viable foundation for multi-format publishing. The less simple answer is that Rheo is a typesetting and static site engine that sits between the Typst language and the formats readers use — PDF, HTML, and EPUB — providing the compilation, linking, and asset management needed to produce all three from a single set of source files. This guide explains both how to use Rheo, and why it might be for you.

Rheo allows you to produce a website, a fixed-size document, and an adaptive document from the same Typst source. It allows you to do something similar to LaTeX—except that Typst is much simpler to write, and we can produce a greater number of formats with it. The documentation that you are reading now, for example, was typeset with Rheo. As a result, you can read it as:

• HTML - as a website for browsers.

• PDF - as a fixed-size document for printing.

• EPUB - as an adaptive document for e-readers.

Who should use Rheo?

If you write anything as simple as a blog or as complex as a dissertation or monograph in Typst, Rheo enables you to publish it in multiple formats. If you are willing to learn a little bit of syntax, you can turn a piece of writing into a website, an adaptive document, and/or a printable document.

Some of the things you can write and publish with Rheo include:

• A blog

• A paper

• A dissertation

• A book manuscript

• A novel

• A textbook

• Technical documentation

Rheo is for anyone who has ever spent regrettable hours formatting citations, fighting with LaTeX, experiencing the limitations of Markdown, or who wants to benefit from the richer writing experience that Typst makes possible (more on this in the next section). It is for students and teachers, humanists and scientists, bloggers and novelists.

If you have only ever used Microsoft Word to author text, or haven’t heard the phrase ‘markup language’ before, we recommend first familiarizing yourself with Typst via the excellent tutorial. This should give you a good intuition for what Typst is—a markup language similar to but also more powerful than Markdown—and why you might want to use Rheo to typeset your documents.