After processing

Although the conversion from MyST markdown to Typst is pretty reasonable, it is likely that you want to make changes for the final version.

To do so, download the template and put it in your root folder. Change in the export.yml file the location of the template folder.

If you have installed Typst locally (how to) run myst build --pdf to create the pdf version. In the _build folder you will find the .typ files. You can upload these files to your typst project or adjust them locally.

To change the files and directly see the changes locally, run typst watch <filename> in your terminal. If <filename> is the main document, you can see the entire project, but it also possible to change the individual files. SumatraPDF allows live preview of the project/document.

Typst conversion support plugin¶

In converting from markdown to Typst, not all symbols are recognized resulting in a warning. We created a typst_conversion_support plugin. You can either download the plugin and include the symbol, or fork the repo of the plugin and add the symbol and do a pull request. Using the latter you contribute to the ecosystem ensuring that others do not reproduce the solution but can make use of yours. Note that in the starterkit we already included this plugin.

Known issues to resolve¶

There are known ‘issues’ when converting from markdown to typst using Jupyter Book.