Adding a label to a figure changes its <figcaption> output to a <p>. Is this a bug?

[chrisgelinek-rl]

Description

When I start with the following simple document and preview it as HTML, the caption looks as expected:

```{mermaid}
%%| fig-cap: "Diagram Caption"
flowchart TD
    A([Test])

As soon as I add a label for cross-referencing though, the caption changes style:

```{mermaid}
%%| fig-cap: "Diagram Caption"
%%| label: my-diag
flowchart TD
    A([Test])
```

Looking at the HTML of the rendered cell, this is the first one (I took out the SVG content for brevity):

<div class="cell" data-layout-align="default">
<div class="cell-output-display">
<div class="quarto-figure-default">
<p></p><figure class="figure"><p></p>
<div>

<svg aria-roledescription="flowchart-v2" ...</svg></div>
<p></p><figcaption> Diagram Caption</figcaption> </figure><p></p>
</div>
</div>
</div>

And the one with the label:

<div class="cell" data-layout-align="default">
<div class="cell-output-display">
<div id="my-diag">
<div>

<svg aria-roledescription="flowchart-v2" ...</svg></div>
<p>Diagram Caption</p>
</div>
</div>
</div>

It seems the <figcaption> element isn't generated if the diagram has a label. Is this expected?

[mcanouil]

A figure is different from an image in Pandoc/Quarto parlance.
As Quarto and Pandoc have slightly different rules on this topics, especially regarding cross-reference, some conversion to figure might happens.

A caption means a figure for both Quarto and Pandoc.
A label fig- means a figure for Quarto.

So, it is expected to not get the same output.
What's not expected is that adding a label seems to confuse Quarto/Pandoc as it no longer treats the object as a figure.

[chrisgelinek-rl]

What's not expected is that adding a label seems to confuse Quarto/Pandoc as it no longer treats the object as a figure.

That is really all I wanted to say. Should I open an issue?

[mcanouil]

• Mermaid fig-cap renders as <p> instead of <figcaption> when label is non-fig-* #14059