这篇文章是系列文章的一部分,重点介绍 Quarto 1.3 版本中的新功能。获取最新版本请访问下载页面
从 Quarto 1.3 开始,您可以使用 embed
短代码将外部 Jupyter Notebook 的输出包含在 Quarto 文档中。要嵌入一个 Notebook 单元,请提供 Jupyter Notebook 的路径和单元标识符。例如,这个名为 penguins.ipynb
的 Notebook 有一个标签为 fig-bill-scatter
的单元:
您可以使用以下短代码嵌入该单元的输出:
{{< embed penguins.ipynb#fig-bill-scatter >}}
这将嵌入图表如下:
图表下方会自动提供一个指向源 Notebook 的链接。点击链接会将用户带到 Notebook 的渲染版本,使他们无需下载和本地运行即可探索 Notebook。例如,点击 penguins.ipynb
的链接会进入一个类似以下内容的页面:
除了这种基本用法,请前往 Jupyter 单元嵌入亮点文档 了解如何:
以多种方式指定单元格,参见 指定单元格。
使用源 Notebook 中的代码单元选项控制输出,包括图表标题、图表布局和代码显示等,参见 代码单元选项。
通过在短代码中添加
echo
选项,同时包含单元格代码和输出,参见 嵌入代码。自定义或排除指向源 Notebook 的链接,参见 链接至源 Notebook。