quarto-dev / quarto-dev/quarto-cli
Footnotes in yaml front matter appear multiple times
Open
@cderv is already working on this.
Since Jun 17, 2026.
bug
footnotes
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Bug description
I discovered this on my own but then found that someone else had come across it as well. There is a lua filter workaround given at that link, but I wonder if this should be handled automatically.
Steps to reproduce
From the command line, do quarto render test.qmd with the following file:
Here's the example from the link modified slightly:
---
title: "How to add a footnote in the YAML block?"
subtitle: "A Question from Stackoverflow"
author: "Yang Hu ^[Retired]"
format: html
---
A footnote from the body is handled fine.[^1]
[^1]: See what I mean?
Expected behavior
Footnotes from yaml front matter should not appear in triplicate and be numbered correctly.
Actual behavior
Here's the result.
Your environment
- using
quarto-clipre-release from a few hours ago - MacOS 14.4.1
Quarto check output
Quarto 99.9.9
[✓] Checking versions of quarto binary dependencies...
Pandoc version 3.2.0: OK
Dart Sass version 1.70.0: OK
Deno version 1.41.0: OK
Typst version 0.11.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
Version: 99.9.9
fatal: not a git repository (or any of the parent directories): .git
Path: /Users/bryanh/Documents/Professional/Research/R_Pkgs/quarto-cli/package/dist/bin
Check file:///Users/bryanh/Documents/Professional/Research/R_Pkgs/quarto-cli/src/resources/vendor/deno-land/x/puppeteer@9-0-2/mod.ts
[✓] Checking tools....................OK
TinyTeX: v2023.07.08
Chromium: (not installed)
[✓] Checking LaTeX....................OK
Using: TinyTex
Path: /Users/bryanh/Library/TinyTeX/bin/universal-darwin
Version: 2023
[✓] Checking basic markdown render....OK
[✓] Checking Python 3 installation....OK
Version: 3.12.3
Path: /opt/homebrew/opt/python@3.12/bin/python3.12
Jupyter: (None)
Jupyter is not available in this Python installation.
Install with python3 -m pip install jupyter
[✓] Checking R installation...........OK
Version: 4.4.0
Path: /Library/Frameworks/R.framework/Resources
LibPaths:
- /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library
knitr: 1.46
rmarkdown: 2.26
[✓] Checking Knitr engine render......OK
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.