quarto-dev / quarto-dev/quarto-cli

Problem with markdown tables, when they are followed by some content in beamer presentation.

Open
#10,019 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug latex pandoc
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

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.

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.