Notebook with dynamic sections fails to build

[sralchemab]

Hi there,

I have a Jupyter Notebook which builds sections based on code instead of having fixed Markdown cells. However, doing this produces a lot of WARNING: Non-consecutive header level increase warnings and doesn't print the text (nor builds the contents toc).

I have an initial Markdown cell with the main title prefixed with #. In the following cell (a code one), I have the following block, which adds sections prefixed with ## and titles prefixed with ###.

from IPython.display import display, Markdown

for section in plot_snippets.keys():
    sec_title = plot_snippets[section]["title"]
    sec_description = plot_snippets[section]["description"]
    plots = plot_snippets[section]["plots"]
    
    display(Markdown(f"## {sec_title}"))
    if sec_description:
        display(Markdown(f"{sec_description}"))
    
    for plot in plots.keys():
        plot_title = plots[plot]["title"]
        plot_description = plots[plot]["description"]
        fig = plots[plot]["fig"]

        if plot_title:
            display(Markdown(f"### {plot_title}"))
        if plot_description:
            display(Markdown(f"{plot_description}"))
        fig.show()

So technically, the header level increases ARE consecutive. But I guess Jupyter Book doesn't like the fact that it's not on a proper Markdown cell and it's in a code one.

Because sections and plots to be included are dynamic, I can't make it static.

Any help will be really appreciated.

Cheers,
Santiago