Reference tables from other Quarto document

[lorenzoFabbri]

Description

I am writing a paper in Quarto. My current setup is this: I have one Quarto file (tables.qmd) to create all the tables for my manuscript, and another Quarto file (results.qmd) for the "Results" section of the manuscript. The file results.qmd is then called in manuscript.qmd (the main Quarto file) with

# Results {#sec-res}
```{r}
#| child: output/paper/sections/results.qmd
```

If I want to reference a table from tables.qmd in results.qmd, how do I do that?

[mcanouil]

You should use the include shortcode not knitr child as any Quarto content won't be parsed otherwise.

There is a feature in 1.4 to include parts of a Quarto document using the shortcode I mentioned above.
See the documentation.
(Away from a keyboard at the moment)

[lorenzoFabbri]

I am just reading about the embed shortcode.

[lorenzoFabbri]

Okay, I think I figured it out. I add {{< embed tables.qmd >}} in manuscript.qmd and the cross-ref works. What's the difference between embed and include in this case?

[cscheid]

https://quarto.org/docs/authoring/notebook-embed.html

They're two features with different goals and use cases. embed embeds the results, and include includes the entire markdown itself, causing code cells to re-execute, etc.

Embed can reference jupyter notebooks and .qmd files, as well as parts of notebooks and .qmd files.

[lorenzoFabbri]

I see, thanks for the references. Is it possible to embed without showing anything? I explain. When submitting a scientific publication, usually the figures should be submitted in a separate file or as individual figures, whereas tables can be "appended" to the main manuscript. So tables do not represent an issue since I can use embed after the references. What about figures? I still need to cross-ref them but without showing them.

[cscheid]

What about figures? I still need to cross-ref them but without showing them.

That's not currently possible in Quarto.