quarto-dev / quarto-dev/quarto-cli

Error rendering PDF with GIF images

Open
#14,547 14 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

I have:
  • searched the issue tracker for similar issues
  • installed the latest version of Quarto CLI
  • formatted my issue following the Bug Reports guide
Bug description

The following error message is displayed when attempting to render a PDF with GIF images:

Rendering PDF
running lualatex - 1
  This is LuaHBTeX, Version 1.18.0 (TeX Live 2024) 
   restricted system commands enabled.
  
  luaotfload | db : Font names database not found, generating new one.
  luaotfload | db : This can take several minutes; please be patient.
updating tlmgr

updating existing packages
ERROR: 
compilation failed- error
LaTeX Error: Unknown graphics extension: .gif.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H <return>  for immediate help.
 ...                                              
                                                  
l.559 ...t,keepaspectratio]{images/juliahearts.gif}}

You can find the GIF insertion code here: https://github.com/JuliaEarth/geospatial-data-science-with-julia/blob/9a366081c857ab654fac88dcb71cc6f45a674e15/preface.qmd#L160

Steps to reproduce
git clone https://github.com/JuliaEarth/geospatial-data-science-with-julia
quarto render --to pdf
Actual behavior

An error message, no PDF output.

Expected behavior

PDF output with GIF image converted into a static image.

Your environment
VSCode
Version: 1.117.0
Commit: 10c8e557c8b9f9ed0a87f61f1c9a44bde731c409
Date: 2026-04-21T16:12:14-07:00
Electron: 39.8.7
ElectronBuildId: 13841579
Chromium: 142.0.7444.265
Node.js: 22.22.1
V8: 14.2.231.22-electron.0
OS: Linux x64 5.15.202-1-MANJARO
Quarto check output
Quarto 1.9.37
[✓] Checking environment information...
      Quarto cache location: /home/juliohm/.cache/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.8.3: OK
      Dart Sass version 1.87.0: OK
      Deno version 2.4.5: OK
      Typst version 0.14.2: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.9.37
      Path: /opt/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: v2025.02
      Chromium: (not installed)
      Chrome Headless Shell: (not installed)
      VeraPDF: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /home/juliohm/.TinyTeX/bin/x86_64-linux
      Version: 2024

[✓] Checking Chrome Headless....................OK
      Using: Chrome from QUARTO_CHROMIUM
      Path: /usr/bin/chromium

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

[✓] Checking R installation...........OK
      Version: 4.5.3
      Path: /usr/lib64/R
      LibPaths:
        - /usr/lib/R/library
      knitr: (None)
      rmarkdown: (None)

      The knitr package is not available in this R installation.
      Install with install.packages("knitr")
      The rmarkdown package is not available in this R installation.
      Install with install.packages("rmarkdown")

[✓] Checking Python 3 installation....OK
      Version: 3.14.3
      Path: /usr/bin/python3
      Jupyter: 5.9.1
      Kernels: python3, julia-1.11, julia-1.10, julia-1.9

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

[✓] Checking Julia installation...

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

Clone the repository linked in the report and run quarto render --to pdf to reproduce the failure at the GIF insertion in preface.qmd around line 160. Investigate the PDF rendering path for the reported .gif extension and verify completion by producing PDF output with the GIF converted to a static image.

Written by the indexing model from the issue text.

Assessment

Tech stack
latex
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.