The flow is:
- convert markdown .md files to a typst .typ file , using pandoc
- using the typst compiler convert the .typ file to pdf
- alternatively, using the typst web app edit the .typ file, preview changes in real time and export to pdf.
I wanted to convert my Zensical documentation to a pdf with an academic flavour. While there are alternative ways of doing this (such as using a former Mkdocs plugin) the process I chose gives me full control of the resulting pdf. Typst uses its own markdown but is quite easy to learn. Typst also has many templates, contributed by the community.