Home¶

Hello document writers!!¶

rst2typst is Python project to provide features that convert reStructuredText to Typst code. You can shorten build cycle to generate PDF your reStructuredText based document.

Input (reStructuredText):

==================
rst2typst document
==================

Overview
========

We like reStructuredText!
It is an one of great docutils.

* This has custom writer of docutils.
* This has CLI endpoint named ``rst2typst``.

Usage
=====

Enjoy it!

Output (Typst): [1]

#title([rst2typst document])

= Overview

We like reStructuredText!
It is an one of great docutils.

- This has custom writer of docutils.
- This has CLI endpoint named `rst2typst`.

= Usage

Enjoy it!

Benchmark¶

The following table shows the result of benchmark on GitHub Actions (ubuntu-latest). Values are measured by CI run on 2026-03-10.

Build time only (rst2latex/pdflatex vs rst2typstpdf)¶
Tool	Build time
rst2latex + pdflatex	0.6 s
rst2typstpdf	1.7 s

Including installation of dependencies¶
Tool	Install time	Build time	Total
rst2latex + pdflatex (+ TeX Live)	91.7 s	0.6 s	92.3 s
rst2typstpdf	0 s	1.7 s	1.7 s

rst2typstpdf is about 53.5x faster than rst2latex+pdflatex when including the installation of TeX Live.

Are you interested in this?¶

Contents:

See demo¶

There is demo of rst2typst. This PDF file is generated by rst2typstpdf.