Include short code inside code block seems buggy

[eitsupi]

Bug description

I wanted to include a script using a shortcode within a non-executable code block, but it doesn't seem to work.

Steps to reproduce

test.qmd

---
title: test
engine: markdown
format:
  gfm: default
---

````python
{{< include foo.py >>}}
````

foo.py

"""
```sh
echo "Hello, World!"
```
"""

Expected behavior

# test

````python
"""
```sh
echo "Hello, World!"
```
"""
````

Actual behavior

# test


\`\`\`\`python

Your environment

• Debian 12

Quarto check output

$ quarto check
Quarto 1.5.44
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.2.0: OK
      Dart Sass version 1.70.0: OK
      Deno version 1.41.0: OK
      Typst version 0.11.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.5.44
      Path: /opt/quarto/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.11.9
      Path: /usr/local/bin/python3
      Jupyter: 5.7.2
      Kernels: python3

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

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

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

[cscheid]

That's... peculiar. I can repro. We'll fix before 1.5 is out.

[cderv]

@eitsupi your example is using >>}} to close shortcode, and it should be {{< include foo.py >}} with only one >

And modifying this, it seems to work

---
title: test
engine: markdown
format:
  gfm: default
---

````python
{{< include foo.py >}}
````

produces this github doc

# test


```` python
"""
```sh
echo "Hello, World!"
```
"""
````

Here I believe this is wrong syntax used the problem. We should probably just not find the shortcode, and leave it in the document as with an unprocessed shortcode. Like when wrong opening is used

---
title: test
engine: markdown
format: gfm
---

````python
{{<< include foo.py >}}
````

Maybe we find the opening shortcode, but not the end, and this remove the entire end of the document ?

I'll let @cscheid look into this as he knows better. Just wanted to point this syntax problem.

[eitsupi]

Thanks for pointing out the typo. Definitely it makes sense.

It would be great if a warning was generated at render time or linter could point it out.......

[eitsupi]

Sorry, but I think I was confused by all the different things I tried.
Actually there seems to be a bug when using includes in the julia engine executable code block.

test.qmd

---
title: test
engine: julia
format:
  gfm: default
---

````{julia}
#| eval: false
{{< include foo.jl >}}
````

foo.jl

"""
```python
1 + 1
```
"""

output:

# test


``` julia
"""
```python
1 + 1
```

““”

\`\`\`

If it is not an executable code block, it works fine.

# test


```` julia
#| eval: false
"""
```python
1 + 1
```
"""
````

So I suppose this is a bug of QuartoNotebookRunner.jl?
(The fact that the number of backticks varies from engine to engine was quite an unexpected behavior for me, though.)

[cderv]

Executable code block and non executable code block are to distinct things. So this is indeed another issue probably due to Julia engine processing. Let's move this part to another new issue.

[cscheid]

It would be great if a warning was generated at render time or linter could point it out.......

We hear you and yes, that's definitely necessary. Just to temper expectations, this won't happen in the near future because shortcodes are parsed in a particularly hard-to-extend part of our code base.