crossreference on website-project with multiple .qmd-files unable to resolve

[Coding4Sec]

Bug description

Quarto cannot resolve reference between different .qmd-files.

Steps to reproduce

My website project spans multiple .qmd-files.

I need to crossreference sections between different sites. Using the guidelines in Quarto Guide yields the warning

WARNING (/home/apex/venvs/quarto/lib/python3.12/site-packages/quarto_cli/share/filters/main.lua:13878) Unable to resolve crossref @sec-zeit

And the output on the webpage shows ?@sec-zeit but no reference.

Referencing within the same page works like a charm (this rules out any typos or misconfig.)

In _quarto.yml config is set to 'number-sections: true`.

My workaround: Using Links: "[Link description](filename.qmd#sec-zeit)"

Is this the intended way to crossref between different pages within a site?

It would be much more convenient to use the default style as described in the guide to crossref sections.

Best, Rick

Actual behavior

No response

Expected behavior

No response

Your environment

• IDE: VS Code 1.97.2
• OS: Ubuntu 24.04.1
• Quarto 1.6.40
  in virtual env

Quarto check output

quarto check

Quarto 1.6.40
[✓] Checking environment information...
      Quarto cache location: /home/apex/.cache/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.4.0: OK
      Dart Sass version 1.70.0: OK
      Deno version 1.46.3: OK
      Typst version 0.11.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.6.40
      Path: /home/apex/venvs/quarto/lib/python3.12/site-packages/quarto_cli/bin

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

[✓] Checking LaTeX....................OK
      Tex:  (not detected)

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

[✓] Checking Python 3 installation....OK
      Version: 3.12.3
      Path: /home/apex/venvs/quarto/bin/python
      Jupyter: 5.7.2
      Kernels: python3

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

[✓] Checking R installation...........OK
      Version: 4.4.2
      Path: /usr/lib/R
      LibPaths:
        - /usr/local/lib/R/site-library
        - /usr/lib/R/site-library
        - /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")

[mcanouil]

Note that there is no bugs here.
In the future, use the Discussion board for feature requests.

Note also that the link you shared is for basic single file document.
The correct documentation describes what's supported for linking and that is not a "workaround" as you call it: https://quarto.org/docs/websites/#linking