How do I use variable values in frontmatter?

[haxfn]

Description

something like the following is not working:

_variables.yml:

categories:
  A: computing
  B: informatics

index.qmd:

---
title: Emacs
description: Thoughts and References when Learning Emacs.

categories:
  - "{{< var categories.A >}}"
  - "{{< var categories.B >}}"
---

{{< var categories.A >}}

{{< var categories.B >}}

This produces:

Where I was expecting the categories.

[cscheid]

I'm sorry you're running into this issue. That's an unfortunate consequence of the way in which Quarto resolves some of its information. The problem is that categories is resolved in typescript; var shortcodes are resolved in Lua, but the metadata generated for categories is not actually rewritten by the time it gets to the part of the typescript code that will handle it.

You might be able to work around this if you generate the entire categories entry in code. Since you're using {{< var engine.jupyter >}}, I'm going to assume you're using python. In that case, this works:

---
title: "Post With Code"
author: "Harlow Malloc"
date: "2025-05-05"
image: "image.jpg"
keep-md: true
---

This is a post with executable code.

```{python}
#| echo: false
import yaml
from IPython.display import Markdown
categories = {"categories": ["news", "code", "analysis", "and-what-else"]}
Markdown("---\n" + yaml.dump(categories) + "---")
```

Compare this to the example blog post you get with quarto create project blog and you'll see what I mean. The trick here is that you're allowed to split the declaration of metadata across multiple blocks, and so you can emit a metadata block that sets a single subfield programmatically, in this case categories.

Ideally, Quarto should detect that the categories field is being specified dynamically, and then resolve it appropriately. But that's a very hard thing to do in general, because (for example) shortcodes can run arbitrary code.

The delineation of what parts of metadata need to be available for Quarto during what parts of its processing is definitely something that we need to both specify and communicate better - thanks for the question!

[haxfn]

you're allowed to split the declaration of metadata across multiple blocks

I did not know that. This is one hack.

... Quarto should detect that the categories field is being specified dynamically...But that's a very hard thing to do in general, because (for example) shortcodes can run arbitrary code.

I am not exactly sure what you mean here, the variables do not have to be shortcodes, rather they will be static strings from a yaml file, no?

[cscheid]

Sorry. In your case, yes! I was explaining what it would take for Quarto to implement a feature that makes it so you can just use shortcodes inside categories like you were doing.

[mcanouil]

@haxfn why ddid you not follow up on the issue about this you referenced in another thread?

• Variables in categories (in frontmatter) do not parse properly when categories is set to true in listing #5578

(Cc @cscheid for your awareness of the related opened issue)