Diagram and Figure block with list break manuscript

[nichtich]

This minimal example breaks quarto render (tested with 1.6.40):

_quarto.yml:

project:
  type: manuscript
manuscript:
  article: index.qmd

index.qmd:

```{dot}
graph {
  X;
}
```

::: {#fig-example}
A list:

- item
:::

The error message is

Error running filter /opt/quarto/share/filters/main.lua:
Block, list of Blocks, or compatible element expected, got table
while retrieving function argument content
while retrieving arguments for function Div
stack traceback:
/opt/quarto/share/filters/main.lua:22698: in field 'render'
/opt/quarto/share/filters/main.lua:1196: in local 'filter_fn'
/opt/quarto/share/filters/main.lua:636: in function </opt/quarto/share/filters/main.lua:626>
(...tail calls...)
[C]: in ?
[C]: in method 'walk'
/opt/quarto/share/filters/main.lua:558: in function </opt/quarto/share/filters/main.lua:547>
(...tail calls...)
/opt/quarto/share/filters/main.lua:1297: in local 'callback'
/opt/quarto/share/filters/main.lua:1315: in upvalue 'run_emulated_filter_chain'
/opt/quarto/share/filters/main.lua:1351: in function </opt/quarto/share/filters/main.lua:1348>
stack traceback:
/opt/quarto/share/filters/main.lua:558: in function </opt/quarto/share/filters/main.lua:547>
(...tail calls...)
/opt/quarto/share/filters/main.lua:1297: in local 'callback'
/opt/quarto/share/filters/main.lua:1315: in upvalue 'run_emulated_filter_chain'
/opt/quarto/share/filters/main.lua:1351: in function </opt/quarto/share/filters/main.lua:1348>

Strangly it works with document type book:

project:                                                                                                                                                       
  type: book                                                                                                                                                   
book:                                                                                                                                                          
  chapters:                                                                                                                                                    
    - index.qmd  

It also works when either the diagram or the figure div are removed or when the figure div contains no list.

P.S: output of quarto check:

Quarto 1.6.40
[✓] Checking environment information...
      Quarto cache location: /home/voj/.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: /opt/quarto/bin

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

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

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

[✓] Checking Python 3 installation....OK
      Version: 3.12.7
      Path: /usr/bin/python3
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

[✓] Checking R installation...........(None)

      Unable to locate an installed version of R.
      Install R from https://cloud.r-project.org/

[mcanouil]

Thanks for the report!

Please share the output of quarto check within a code block (i.e., using three backticks ```txt), see https://quarto.org/bug-reports.html#check.

[mcanouil]

What is the intention/expectation of the following code?

::: {#fig-example}
A list:

- item
:::

This does not feel right (I would even say, it feels invalid) for a cross-reference div.
https://quarto.org/docs/authoring/cross-references-divs.html

[nichtich]

It is used to provide a referenceable infobox that happens to contain a list. The example above is reduced to get a minimal test case. I stumbled upon the issue when I used listings as examples and some listings:

    crossref:
      lst-prefix: "Example"
      lst-title: "Example" 

::: {#lst-example-1}

This sample code illustrates to things:

- a
- b

```
...actual code...
```
:::

All worked well until I added a diagram to the same document (without any connection to the div!).

Documentation of figure divs states:

You can treat any markdown content you want as a figure by enclosing it in Pandoc div block with an identifier prefaced with #fig-.

The error is also thrown with an addition last paragraph as title.

[mcanouil]

Independently of what seems to be a parsing issue/bug in the case of Manuscript project:

You need your "caption" to be a single element for example by surrounding it with a fenced div.

Note that your new example means you want the code to be the caption.
See the lst syntax: https://quarto.org/docs/authoring/cross-references.html#code-listings

I don't understand why you don't use:

• https://quarto.org/docs/authoring/cross-references.html#theorems-and-proofs

Input	Output
--- title: "Quarto Playground" format: html --- ::: {#exm-example} This sample code illustrates two things: - a - b ```r print("Hello, World!") ``` :::

or eventually: https://quarto.org/docs/authoring/cross-references-custom.html

lst have some issues as it appears to not support complex "caption".

Input	Output
--- title: "Quarto Playground" format: html --- ## Using `lst` prefix ::: {#lst-example} ```r print("Hello, World!") ``` ::: {#my-caption} This sample code illustrates two things: - a - b ::: :::

All above screnshots are from a rendering within a Manuscript type project.

[mcanouil]

To show that the syntax from the original example "works", as in "it does not crash", but is clearly "wrong":

Input	Output
--- title: "Quarto Playground" format: html --- ## Bad output ::: {#fig-example} A list: - item ::: ## Good output ::: {#fig-example} A list: item :::

[nichtich]

Thanks for elaboration! I should definitely move to exm. This seems to solve my use case. It does not work with fig and lst.

Note that your new example means you want the code to be the caption

No, I just removed the additional caption from my example.

Your second and third example also break as soon as you add a diagram to the same document:

```{dot}
graph {
  X;
}
```

[mcanouil]

Yes (#11883 (comment)), but it actually does not work, it just "compile without crash".

Quarto should handle properly those cases possibly with a nice error message (if appropriate) and not:

• works with improper output
• crash with the improper structure conflict with other content

[nguiard]

Hi! I'm running into this error too (on latest prerelease and stable). I spent a bit of time trying to get a minimal example but couldn't for now, it seems very finnicky...
At some point just resaving the document, without any change, triggered the Block, list of Blocks, or compatible element expected, got table error on preview, but changing anything (adding an empty line or whatever) and then saving fixed the next preview live reload pass...
Sometimes when starting quarto preview it would get stuck crashing with this error. Then commenting all python cell blocks and removing quarto temporary files made it start fine, and after that, decommenting the code (while preview is already running) worked, seemed to fix the error and produced expected output... But today decommenting doesn't even seem to make it start...

At first I thought I'd post on #10358 as it seemed related, but then I came across this issue, and I was effectively using the manuscript type, checked if switching to book changed anything, and it seems to fix everything.

[Bhanahnah]

For future readers: I'm also having this issue, it happened when I re-ran a ipynb notebook that was originally working fine with my manuscript qmd, but now it's not.... @nguiard changed the doc type to book from manuscript but I was really hoping to keep using manuscript with embeds from the problem notebook. I ended up fixing the issue by breaking up one code cell that had 2 figures, into 2 seperate code cells with their own labels for each. No idea why multiple figures with a label broke Pandoc lua but it's working now I guess so whatever