Documentation and usage on using a Typst template (not partials)

[JosephBARBIERDARNAL]

Description

Hi!

I'm looking for some documentation/usages of using quarto+typst, using a template file like this:

---
title: "Hello typst"
format:
   typst:
      template: custom.typ
---

Documentation usage of template-partials is fairly clear to me, but I haven't been able to found usage examples of just using template.

For example, I would believe that the following would work, but it just renders a blank page:

---
title: "Hello typst"
format:
   typst:
      template: custom.typ
---

## Section A

Lorem Ipsum is simply dummy text of the printing and typesetting industry.

## Section B

Where custom.typ is:

#set text(size: 15pt, fill: red)

I guess this is not a bug but rather not how people are supposed to use template?

[cscheid]

https://quarto.org/docs/journals/templates.html#templates

[JosephBARBIERDARNAL]

Okay, I think I finally understand. Maybe it's just me, but I don't find the content of the previous link very clear.

What I would like to see explained/explicited:

• body is a "special" variable that represents the content of the document.
• Example of using $title$, $date$
• Example of use for typst
• Using a template will overwrite many default stuff (I believe this might seem obvious, but not at first)
• probably other things?

Are you okay with me opening a PR for this?