How can you create dynamic headings with code using Python?

[SamEdwardes]

Description

Background

I am trying to dynamically create markdown based on data that I am processing in Python. It is mostly working, except the headings that I generate do not show up in the table of contents.

Is it possible to get them to appear in the TOC?

A few things to consider:

• The anchor tag is still generated. I can link to the heading. It just does not appear in the TOC.
• Note that it does work when I use inline code. This will appear in the TOC.

Reprex

Take the following document:

---
title: "Reprex"
format: 
    html:
        toc: true
        toc-depth: 6
---

```{python}
from IPython.display import Markdown
```

## heading 2.1

## heading 3.1

```{python}
headings = [
    "### Heading 3.2",
    "### Heading 3.3",
    "## Heading 4.1",
    "### Heading 4.2",
]

for i in headings:
    display(Markdown(i))
```

`{python} Markdown("## Heading 5.1")`

`{python} Markdown("### Heading 5.2")`

`{python} Markdown("### Heading 5.3")`

System info

• Quarto: 1.5.47
• Mac OS: 15.0.1 (24A348)
• MacBook Pro M1

[mcanouil]

Use output: asis when using display().

Input

Output

--- title: "Reprex" format: html: toc: true toc-depth: 6 --- ```{python} from IPython.display import Markdown ``` ## heading 2.1 ## heading 3.1 ```{python} #| output: asis headings = [ "### Heading 3.2", "### Heading 3.3", "## Heading 4.1", "### Heading 4.2", ] for i in headings: display(Markdown(i)) ``` `{python} Markdown("## Heading 5.1")` `{python} Markdown("### Heading 5.2")` `{python} Markdown("### Heading 5.3")`

[SamEdwardes]

Thank you I will give this a try!

[SamEdwardes]

Confirmed this worked. Thank you for the advice :)