温馨提示:若页面不能正常显示数学公式和代码,请阅读原文获得更好的阅读体验。

作者:李铭(暨南大学)
邮箱liminglcz@163.com

  • Title: Quarto 极简幻灯片:支持 R/Python 代码集成
  • Keywords: VSCode,Python,R,精简幻灯片,学术演示, B827

本文提供的幻灯片模板:

本文方案适用于

  • 制作极简风格的学术幻灯片;
  • 集成 R 和 Python 代码,支持代码执行和结果展示;
  • 支持 Markdown 语法和 LaTeX 数学公式;
  • 基于 VS Code 编辑器,适合跨平台使用(Windows、Mac、Linux)
  • 生成 HTML 格式幻灯片,便于在线分享和展示。

0. 导言

在学术研究和教学中,幻灯片(Slides)是不可或缺的工具。传统的幻灯片制作软件如 PowerPoint、Keynote 等,虽然功能强大,但在集成代码和数据分析方面存在局限性。近年来,Quarto 作为一种新兴的文档编写和渲染工具,因其对 R 和 Python 代码的良好支持,逐渐受到学术界的关注。

本文将介绍如何在 VScode 编辑器中使用 Quarto 制作精简版幻灯片,重点展示其在集成 R 和 Python 代码方面的优势,并提供具体的安装和使用指南,帮助读者高效创建学术演示材料。

后文看起来很长,主要是因为包含了很多细节的介绍。其实,核心步骤只有三步:

  1. 安装 Quarto 及其附加组件 TinyTex 和 Chromium (通常不需要);
  2. 在 VS Code 中安装 Quarto 扩展,并配置 Jupyter 环境以支持 Python 代码;
  3. 使用 Quarto 模板创建 .qmd 文件,并编写包含 R 和 Python 代码的幻灯片内容。
  4. 在 VScode 中执行 quarto render 命令生成最终的幻灯片文件(HTML 格式),或 quarto preview 进行预览。

1. 何谓 Quarto ?

Quarto 是 Posit 公司推出的一款开源软件,主要用来将 Markdown 文件转换为各种格式,可以一键渲染(render)生成网站 (html) 、写书 (epub) 、报告 (pdf) 、幻灯片 (pptx 、 beamer) 等格式。

Quarto 在某种程度上可以视为 rmarkdown 的升级版,可以支持 R 和 Python 代码的嵌入、执行,是制作精简版幻灯片制作的优良工具。有关 Quarto 的详细使用教程可参照 Quarto 官网链接

Quarto 工作原理:新建 Quarto 文档时,会生成以.qmd 为后缀的文档。当渲染(render)qmd 文档时, knitr 会首先执行所有代码块并创建一个新的 Markdown (.md) 文档,其中包括代码及其输出。生成的 Markdown 文件然后由 pandoc 处理,创建最终的格式。渲染(render)按钮封装了这些操作并以合适的顺序执行,这一过程可通过 Rstudio、VS Code、Positron、Jupyter 等编辑器工具予以实现。

2. Quarto 安装与配置

Quarto 官方下载链接:https://quarto.org/docs/get-started/

下载、安装完毕后,可以在命令行中执行 quarto --version,若显示版本号,则表明安装成功。

C:\Users\liming> quarto --version
1.6.39

Note:进入命令行模式的方法为

  • Windows 系统:按下 Win + R 键,输入 cmd,然后按回车键即可打开命令行窗口。
  • Mac 系统:按下 Command + Space 键,输入 Terminal,然后按回车键即可打开终端窗口。

Quarto 有两个附加组件:TinyTexChromium,分别用于 PDF 渲染和 HTML 预览。

可以在命令行中执行 quarto list tools 命令来查看两个附加组件的安装情况:

C:\Users\liming> quarto list tools

[>] Inspecting tools

Tool         Status            Installed     Latest
chromium     Not installed     ---           869685
tinytex      Not installed     ---           v2025.11

上述结果表明,系统中尚未安装 TinyTex 和 Chromium。下面介绍何种情况下需要安装这两个组件,以及如何安装。

温馨提示:若页面不能正常显示数学公式和代码,请阅读原文获得更好的阅读体验。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐