how to Disable fig-caption and extra line breaks between multiple images

[hasibagen]

Bug description

When using multiple images in Quarto, the following issues occur:

The default fig-caption appears, even if it's set to false in the YAML metadata.
Extra blank lines are generated between images.

default fig-caption appears when fig more than 1

Steps to reproduce

---
title: "title"
format:
  docx:
    default-image-extension: svg
    fig-caption: false
params:
  datapath: null
execute:
  enable: true
  echo: false
  warning: false
  eval: true
  keep-ipynb: false
  keep-md: false
  cache: false
jupyter: python3
fig-format: svg
---

```{python}
#| label: fig 
#| warning: false
#| error: false
#| echo: false
#| output: true
#| fig-cap: ""
#| 
import matplotlib.pyplot as plt
import seaborn as sns
import numpy as np
import pandas as pd

# Example data
data = pd.DataFrame({
    "x": np.arange(10),
    "y": np.random.rand(10)
})

# Plot
sns.lineplot(data=data, x="x", y="y")
plt.title("Example Plot")
plt.show()

sns.lineplot(data=data, x="x", y="y")
plt.title("Example Plot")
plt.show()
```

Actual behavior

only picture

Expected behavior

some picture cap

Your environment

ubuntu22.04
python IDE pycharm 2024.1.1 (Community Edition)

Quarto check output

quarto check
Quarto 1.6.42
[✓] Checking environment information...
      Quarto cache location: /home/jade/.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.42
      Path: /opt/quarto/bin

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

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

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

[✓] Checking Python 3 installation....OK
      Version: 3.11.5 (Conda)
      Path: /home/jade/anaconda3/bin/python
      Jupyter: 5.3.0
      Kernels: python3

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

[✓] Checking R installation...........OK
      Version: 4.4.1
      Path: /usr/lib/R
      LibPaths:
        - /home/jade/R/x86_64-pc-linux-gnu-library/4.4
        - /usr/local/lib/R/site-library
        - /usr/lib/R/site-library
        - /usr/lib/R/library
      knitr: 1.49
      rmarkdown: 2.29

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

[mcanouil]

In the future, please open discussion to ask question (after searching for similar ones) rather than issue (issues are for bugs and documentation feedback).

You are asking for a caption in your example: fig-cap: "".
Also, fig prefix means you want a cross-reference thus the numbering etc. (It seems the regex does not look exactly for fig-).

See cross-references documentation.

Since you apparently don't want to use cross-reference, then don't set label (or use a meaningful one that is not fig or fig-) and don't set fig-cap.

Also, you should understand where the options go and not place options anywhere especially the one that does not exist.
See the references pages.
See the |execution options](https://quarto.org/docs/computations/execution-options.html).

[hasibagen]

In the future, please open discussion to ask question (after searching for similar ones) rather than issue (issues are for bugs and documentation feedback).

You are asking for a caption in your example: fig-cap: "". Also, fig prefix means you want a cross-reference thus the numbering etc. (It seems the regex does not look exactly for fig-).

See cross-references documentation.

Since you apparently don't want to use cross-reference, then don't set label (or use a meaningful one that is not fig or fig-) and don't set fig-cap.

Also, you should understand where the options go and not place options anywhere especially the one that does not exist. See the references pages. See the |execution options](https://quarto.org/docs/computations/execution-options.html).

Thanks for your response and for all the work on Quarto!

I did search both issues and discussions but couldn’t find this topic. Since the behavior seemed unexpected, I thought it was a bug. I’ll post in Discussions next time.
I appreciate the clarification! I hadn’t set fig-cap: "", but the caption still appeared because my label started with figxxx. I’ll avoid fig-related labels in the future.
I’ve read the Execution Options docs many times, including after your reply, but I still find parts unclear due to my limited programming background. Could you clarify what specific changes I should make?
Thanks again for your help!

[mcanouil]

Sorry if was not not clear.
When asking for help, you need to ensure your example is small and does not contain unnecessary elements which will only add noise. You also need to ensure that what you are sharing is valid.

• fig-caption: false this does not exist.
• params.datapath: null this is not used and is for knitr engine but you set Jupyter as the engine.
• default-image-extension: svg and fig-format: svg and all the execute options are not necessary and for the majority are set to the default.
• #| warning: false, etc. at the code cell are not necessary and redundant to the option you've set in execute
• You said you hadn't set #| fig-cap: "", but you did in the example you've shared.

This is not related to a programming background. Simplifying a problem by removing unnecessary elements is a principle that applies across all fields. It helps to ensure that the person you've sought assistance from can understand your issue without being placed under a heavy cognitive load.

To summarise the issue here, multiple figures and the use of a label fig triggers the cross-reference system. This only happens using Jupyter as the engine.

Input	Output
--- title: 'No "Figure" Label' format: html engine: jupyter --- ```{python} #| label: fig import matplotlib.pyplot as plt x = [1, 2, 3, 4, 5] y = [1, 4, 9, 16, 25] plt.plot(x, y) plt.show() ```
--- title: '"Figure" Label' format: html engine: jupyter --- ```{python} #| label: fig import matplotlib.pyplot as plt x = [1, 2, 3, 4, 5] y = [1, 4, 9, 16, 25] plt.plot(x, y) plt.show() plt.plot(x, y) plt.show() ```
--- title: 'No "Figure" Label' format: html engine: jupyter --- ```{python} #| label: figure import matplotlib.pyplot as plt x = [1, 2, 3, 4, 5] y = [1, 4, 9, 16, 25] plt.plot(x, y) plt.show() plt.plot(x, y) plt.show() ```

[mcanouil]

To elaborate about why this happens.

You are using a label, a label is an ID given to the code cell.
Bu when you are outputting figures, tables, etc. The elements are also given an ID based on the label.
If you use keep-md: true, you will see the markdown being generated:

---
title: '"Figure" Label'
format: html
engine: jupyter
keep-md: true
---

::: {#fig .cell execution_count=1}
``` {.python .cell-code}
import matplotlib.pyplot as plt

x = [1, 2, 3, 4, 5]
y = [1, 4, 9, 16, 25]

plt.plot(x, y)
plt.show()

plt.plot(x, y)
plt.show()
```

::: {.cell-output .cell-output-display}
![](index_files/figure-html/fig-output-1.png){#fig-1}
:::

::: {.cell-output .cell-output-display}
![](index_files/figure-html/fig-output-2.png){#fig-2}
:::
:::

You see the #fig-1 and #fig-2 to differentiate the two figures?
This leads to Quarto to find fig- prefix used for cross-reference thus triggering the cross-reference system.

This might be seen as a side effect of using fig as label¹ or a bug.

Footnotes

1. labels are used to identify elements, so they should be meaningful although nothing technically forbids you to name your code cells "a", "b", "c", or "whatever". ↩

[hasibagen]

This might be seen as a side effect of using fig as label1 or a bug.

Got it! I’ll make sure to provide a minimal example next time.

I included those extra details because I was using those exact parameters in my main code and was worried they might be causing the issue. I thought sharing them might help track down the problem. But you’re absolutely right—since the issue can be reproduced in a simpler version, I should have just provided that.

Also, I’ve learned not to use reserved variables like fig and table as labels next time.

Thanks for your detailed and patient response!