How footnotes work in revealjs?

[luifrancgom]

Description

I want to know how footnotes work in revealjs taking into account what is mention in Footnotes in relation to the yaml option reference-location

I only get the actual behavior equal to the expected behavior when using reference-location: document

---
format: 
  revealjs:
    embed-resources: true
    slide-level: 2
    reference-location: document
---

# Section 1

## Subsection 1

Text[^1]

[^1]: Footnote 1

# Section 2

## Subsection 2

Text[^2]

[^2]: Footnote 2

Actual behavior with document

But when I use the other options block, section or margin I don't understand the numbering of the footnotes or the expected location as in the case of margin. For example with margin:

---
format: 
  revealjs:
    embed-resources: true
    slide-level: 2
    reference-location: margin
---

# Section 1

## Subsection 1

Text[^1]

[^1]: Footnote 1

# Section 2

## Subsection 2

Text[^2]

[^2]: Footnote 2

Actual behavior with margin

Expected behavior with margin

Quarto check output

Quarto 1.8.14
[>] Checking environment information...
      Quarto cache location: C:\Users\Usuario\AppData\Local\quarto
[>] Checking versions of quarto binary dependencies...
      Pandoc version 3.6.3: OK
      Dart Sass version 1.87.0: OK
      Deno version 2.3.1: OK
      Typst version 0.13.0: OK
[>] Checking versions of quarto dependencies......OK
[>] Checking Quarto installation......OK
      Version: 1.8.14
      Path: C:\Users\Usuario\AppData\Local\Programs\Quarto\bin
      CodePage: 1252

[>] Checking tools....................OK
      TinyTeX: (external install)
      Chromium: 869685

[>] Checking LaTeX....................OK
      Using: TinyTex
      Path: C:\Users\Usuario\AppData\Roaming\TinyTeX\bin\windows\
      Version: 2025

[>] Checking Chrome Headless....................OK
      Using: Chrome found on system
      Path: C:\Program Files\Google\Chrome\Application\chrome.exe
      Source: Windows Registry

[>] Checking basic markdown render....OK

[>] Checking Python 3 installation....OK
      Version: 3.13.5
      Path: C:/Python313/python.exe
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with py -m pip install jupyter

[>] Checking R installation...........OK
      Version: 4.5.0
      Path: C:/PROGRA~1/R/R-45~1.0
      LibPaths:
        - C:/Users/Usuario/AppData/Local/R/win-library/4.5
        - C:/Program Files/R/R-4.5.0/library
      knitr: 1.50
      rmarkdown: 2.29

[>] Checking Knitr engine render......OK

I don't know if I am not understanding what is mention in Footnotes or if it is a bug.

[mcanouil]

You have wrong links or images.
You also have twice the same example but showed two different screenshots with no sources.

Could you properly format your post using code blocks for code and terminal outputs? Thanks.
If your code contains code blocks, you need to enclose it using more backticks, i.e., usually four ````.
See https://quarto.org/bug-reports.html#formatting-make-githubs-markdown-work-for-us.

Accessibility: To improve accessibility, please add alternative text to your screenshots. This helps all users, including those using screen readers, to understand the context of the images. A brief description can make a big difference! See Good Alt Text, Bad Alt Text — Making Your Content Perceivable.

[luifrancgom]

I don't have code so I added only ``` but I corrected it with ````. Also I initially added the part about accessibility, I don't know why you where not able to identify it. Yes you are right I use the same case twice sorry.

I will format better the content.

[mcanouil]

I'm referring to those weird things you've put at the beginning and the end of your post.

Your two main screenshots indeed have the alt text. Thanks.

Side note: most of the messages are pre-written to ensure "neutral tone" to avoid mis-interpretation of the purpose of the message. I did not remove the example part for code for instance.

[luifrancgom]

Oops, sorry — I messed it up. It was a link. Thank you!

[cderv]

I don't think margin is supported in Revealjs

By default it is by slide, and reference-location: document makes it for the whole doc
This is documented at https://quarto.org/docs/presentations/revealjs/#asides-footnotes
Margin footnote is note mentioned there.

So this is a feature request to have a margin logic - but Revealjs slides have currently no margin logic in there DOM organization.

Did you encounter some Revealjs slides in the wild having Margin support ?

Thanks

[cscheid]

It shows up in the reference for revealjs :(

[cscheid]

https://quarto.org/docs/reference/formats/presentations/revealjs.html#footnotes

[cderv]

yes because we can't separate option value per format, or can we?

reference-location: document is supported. And all other values are ignored. (Revealjs checks for reference-location != document

[luifrancgom]

Taking into account that the other options are not supported and that it is difficult to change the documentation I will mark what is mention by Christophe Dervieux as the answer.