quarto-dev / quarto-dev/quarto-cli
Problem with markdown tables, when they are followed by some content in beamer presentation.
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Bug description
I have many repositories with presentations and sites built using Quarto (❤️). Some of them encountered issues when they were automatically deployed with GitHub Actions after a commit, resulting in errors like this:
ERROR:
compilation failed- error
Undefined control sequence.
\@currentHref ->table.\theHtable
l.196 \end{frame}
As a result, for the past week, I switched from automatic deployment to manually running:
quarto publish gh-pages
However, after updating from TeX Live 2023 to TeX Live 2024, I noticed that several documents which previously built successfully now crash with the same errors. I decided to create the smallest possible example to reproduce the problem and observed that the issue occurs when a markdown table is followed by any content.
Here are my findings:
- If I completely remove the table, it works.
- If I remove everything after the table, it works.
- If I replace the markdown table with a LaTeX table, it works.
- If I render the same table on the site (not beamer), it works.
Steps to reproduce
Here is small Quarto document, that raise an error
---
title: Table problems
format:
beamer:
pdf-engine: pdflatex
---
# Section
## Slide 1
| Customer / Source | Arnhem [euro/ton] | Gouda [euro/ton] | Demand [tons] |
| :---: | :--: | :--: | :--: |
| London | n/a | 2.5 | 125 |
| The Hague | 1.4 | 0.8 | 200 |
| **Supply [tons]** | 550 tons | 700 tons | n/a |
## Slide 2
While If you remove the Slide 2, the problem will disappear.
---
title: Table problems
format:
beamer:
pdf-engine: pdflatex
---
# Section
## Slide 1
| Customer / Source | Arnhem [euro/ton] | Gouda [euro/ton] | Demand [tons] |
| :---: | :--: | :--: | :--: |
| London | n/a | 2.5 | 125 |
| The Hague | 1.4 | 0.8 | 200 |
| **Supply [tons]** | 550 tons | 700 tons | n/a |
You can compile the document with the command
quarto preview file.qmd
Expected behavior
Produce beamer presentation
Actual behavior
Rendering PDF
running pdflatex - 1
This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2024) (preloaded format=pdflatex)
restricted \write18 enabled.
entering extended mode
updating tlmgr
updating existing packages
ERROR:
compilation failed- error
Undefined control sequence.
\@currentHref ->table.\theHtable
l.196 \end{frame}
Your environment
Macos 14.5 (23F79)
The problem occurs both in VSCode and in terminal compilation.
Quarto check output
% quarto check
Quarto 1.5.45
[✓] 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: 1.5.45
Path: /Applications/quarto/bin
[✓] Checking tools....................OK
TinyTeX: v2024.06
Chromium: (not installed)
[✓] Checking LaTeX....................OK
Using: TinyTex
Path: /Users/USER/Library/TinyTeX/bin/universal-darwin
Version: 2024
[✓] Checking basic markdown render....OK
[✓] Checking Python 3 installation....OK
Version: 3.11.4
Path: /Users/USER/.pyenv/versions/3.11.4/bin/python
Jupyter: 5.3.2
Kernels: python3
[✓] Checking Jupyter engine render....OK
[✓] Checking R installation...........(None)
Unable to locate an installed version of R.
Install R from https://cloud.r-project.org/
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.
Research direction
Start with the minimal file.qmd example and run quarto preview using the beamer format with pdflatex. Compare the generated output for the document with and without Slide 2, then trace the failure reported at \end{frame}; done means both versions compile successfully with TeX Live 2024.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- latex, markdown
- Domain
- cli, documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100