typst-to-div Extension For Quarto

Enables using custom typst functions from a typst-template.typ file as a div when authoring in Quarto. This filter is a generalization of this one.

Use case

The standard way to run .qmd content through custom typst styling appears to be to wrap said content in typst blocks, e.g.

```{=typst}
#block(
    fill:luma(230), 
    inset:16pt,
    outset:-8pt, 
    radius:4pt,
    [
```

...quarto content...

```{=typst}
    ]   
) 
```

This lua filter provides syntactic sugar for instead applying typst styling via quarto divs, e.g. the following typst code gets placed into a typst-template.typ file:

#let myblock(text) = block(text,
    fill:luma(230), 
    inset:16pt,
    outset:-8pt, 
    radius:4pt
  )

then called as a div in the .qmd:

::: {.project-myblock}
...quarto content...
:::

Note that the div class is named using the user-created typst function name preceded by the project name (as determined as the parent directory to the _extensions folder) and an '-'.

Installing

quarto add cl-roberts/lua-filters/typst-to-div

This will install the extension under the _extensions subdirectory. If you're using version control, you will want to check in this directory.

Using

Basic usage requires writing .qmd files which contain content that you would like to render as pdf using format: typst. In the YAML of your Quarto document, include the following lines:

filters:

   - typst-to-div

Example

Here is the source code for a minimal example: example.qmd.