Documentation on `Includes`

[AdaemmerP]

What would you like to do?

Report an issue on quarto.org

Description

Thanks for the amazing Quarto!

This section on including and running external scripts is a bit confusing and leaves some questions unanswered.

For example, why does

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

copy the Python code above and run it, whereas

```r  
{{< include _demo.R  >}}
```

only copies the code, but does not run it?

In addition, what are other options and best practices to include and run external (R) scripts?

I found

```{r} 
source("_demo.R")
```

and

```{r} 
#| file: path/to/_demo.R
```

Any advice or improvements to the documentation would be greatly appreciated.

[cscheid]

I think you're confused. The following does not run Python:

---
title: hello
---

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

[cscheid]

I'm going to convert this to a Q&A.