quarto-dev / quarto-dev/quarto-cli

crossref values are displayed in html but not in pdf

Open
#11,772 7 comments 0 reactions 1 assignee View on GitHub

@cderv is already working on this.

Since Jun 23, 2026.

books bug crossref
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

crossref attributes appendix-title and appendix-delim are not implemented in pdf.

Steps to reproduce
  • Create a new quarto project in RStudio by invoking the default template as project "example".
  • Add details.qmd in project directory with content "# Details".
  • Tweak _quarto.yml as below.
  • Run quarto render from terminal in project directory.
project:
  type: book

book:
  title: "example"
  author: "Norah Jones"
  date: "1/2/2025"
  chapters:
    - index.qmd
    - intro.qmd
    - summary.qmd
    - references.qmd
  appendices: 
    - details.qmd

crossref:
  appendix-title: "Attachment"
  appendix-delim: ":"

bibliography: references.bib

format:
  html:
    theme: cosmo
  pdf:
    documentclass: scrreprt
  

editor: visual
Expected behavior

I expect to see "Attachment A: Details" in example/_book/details.html and in example.pdf.

Actual behavior

I see "Attachment A: Details" in example/_book/details.html but in example.pdf I just see "A Details".

Your environment
  • IDE: RStudio 2023.06.2 Build 561
  • OS: Windows Version 10.0.19045 Build 19045
Quarto check output
quarto check
[>] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.1: OK
      Dart Sass version 1.55.0: OK
[>] Checking versions of quarto dependencies......OK
[>] Checking Quarto installation......OK
      Version: 1.3.353
      Path: C:\Program Files\RStudio\resources\app\bin\quarto\bin
      CodePage: 1252

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

[>] Checking Python 3 installation....OK
      Version: 3.10.3
      Path: C:/Users/tim.bergsma/AppData/Local/Programs/Python/Python310/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.4.2
      Path: C:/PROGRA~1/R/R-44~1.2
      LibPaths:
        - C:/Users/tim.bergsma/AppData/Local/R/win-library/4.4
        - C:/Program Files/R/R-4.4.2/library
      knitr: 1.42
      rmarkdown: 2.21

[>] 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.