quarto-dev / quarto-dev/quarto-cli

Incorrect Quotes in PDF Bookmark Using Quarto Despite Correct Output with Pandoc

Open
#7,965 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug latex third-party
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

I’ve encountered an issue where the PDF bookmarks generated by Quarto are incorrect, despite Pandoc creating the correct bookmarks when using the same Markdown source file.

Steps to reproduce

The content of my Markdown file test.md is as follows:

# "One" Heading

Some texts here.

# Pandoc's Features

# Quarto's Features
Using Pandoc

I generated a PDF using the following Pandoc command:

pandoc --pdf-engine=xelatex test.md -o test.pdf

This command produced a PDF file with the correct bookmarks, where the quotes in the headings were consistent with the main body.

CleanShot 2023-12-19 at 17 20 05@2x

Using Quarto

When I rendered the PDF using Quarto with this command:

quarto render test.md --to pdf

The resulting PDF had incorrect bookmarks that the quotes in the headings were inconsistent with the main body.

CleanShot 2023-12-19 at 17 19 31@2x

Expected behavior

I expect the PDF generated by Quarto to have the same correct bookmarks as the one generated with Pandoc. There is a related issue https://github.com/jgm/pandoc/issues/5812.

Your environment
  • IDE: VS Code
  • Pandoc version: 3.1.11
  • Quarto version: 1.4.528
  • OS: macOS 14.2
Quarto check output

Quarto 1.4.528
[✓] Checking versions of quarto binary dependencies...
Pandoc version 3.1.9: OK
Dart Sass version 1.69.5: OK
Deno version 1.37.2: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
Version: 1.4.528
Path: /Applications/quarto/bin

[✓] Checking tools....................OK
TinyTeX: (not installed)
Chromium: (not installed)

[✓] Checking LaTeX....................OK
Using: Installation From Path
Path: /Library/TeX/texbin
Version: 2023

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

[✓] Checking Python 3 installation....OK
Version: 3.10.10
Path: /Users/username/.pyenv/versions/3.10.10/bin/python3
Jupyter: 5.5.0
Kernels: python3

[✓] Checking Jupyter engine render....OK

[✓] Checking R installation...........OK
Version: 4.3.2
Path: /opt/homebrew/Cellar/r/4.3.2/lib/R
LibPaths:
- /Users/username/.R/packages
- /opt/homebrew/lib/R/4.3/site-library
- /opt/homebrew/Cellar/r/4.3.2/lib/R/library
knitr: 1.45
rmarkdown: 2.25

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

Research direction

Start by reproducing the issue with the provided test.md and compare the bookmarks from the Pandoc and Quarto commands. Trace Quarto's PDF rendering path and its interaction with Pandoc and XeLaTeX; done means quoted headings produce matching bookmarks in the generated PDF.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, latex
Domain
build-system
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.