Quarto无法识别代码生成的标题并纳入目录的问题求助

问题背景 #

想通过Python循环生成带条件判断的标题，让这些标题能被Quarto的目录（TOC）识别：

• 用IPython.display.display(Markdown())生成的标题能正常显示，但无法被TOC收录；
• 给代码块加#| output: asis后，用print()输出标题能被TOC识别，但会出现所有标题先批量输出，后续内容再集中显示的顺序混乱问题。

解决方案 #

核心是不要混合使用print()和display()，统一用print()输出完整的Markdown内容（标题+对应段落），配合#| output: asis就能同时满足「标题入TOC」和「输出顺序正常」的需求。

完整示例代码 #

---
title: "Test"
toc: true
format: html
---

#| echo: false
#| output: asis

for i in range(3):
    # 用print输出完整的Markdown内容，包含标题和段落
    print(f'''## Heading using print() {i}
Lorem ipsum dolor sit amet, in at in sed nibh. Neque dignissim 
ad imperdiet urna urna. In id erat aliquam, dolor ut odio. 
Congue at, non justo fermentum urna suscipit ad torquent posuere.
''')

原理说明 #

当启用#| output: asis时，Quarto会直接将代码块的标准输出（也就是print()的内容）解析为Markdown。如果混合print()和display()，两者的输出缓冲区不同步：print()的内容会被Quarto优先收集，而display()的IPython输出对象会被延后处理，导致顺序错乱。统一用print()输出完整的Markdown片段，就能保证循环中的标题和对应内容按顺序被解析，同时标题会被Quarto识别并加入目录。

内容的提问来源于stack exchange，提问作者user23687313