quarto-dev / quarto-dev/quarto-cli

Footnotes in yaml front matter appear multiple times

Open
#9,700 6 comments 0 reactions 1 assignee View on GitHub

@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.

Screenshot 2024-05-16 at 12 01 53 PM
Your environment
  • using quarto-cli pre-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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.