Skip to content

Quarto#

Quarto is an open-source scientific and technical publishing system built on Pandoc.

Content authored using Quarto can be published to RStudio Connect.

Important

Quarto development is active and ongoing. RStudio Connect includes preview support for Quarto content. Please let your Customer Success representative know about your experience using Quarto with Connect.

Quarto must be installed on your system before configuring RStudio Connect to allow support for Quarto content. The Quarto documentation explains how to install Quarto.

The Quarto Debian installer makes Quarto available as /usr/local/bin/quarto. Instruct RStudio Connect to use this default location:

; /etc/rstudio-connect/rstudio-connect.gcfg
[Quarto]
Enabled = true
Executable = "/usr/local/bin/quarto"

If you installed using the Quarto .tar.gz, you may have installed Quarto elsewhere. Instruct RStudio Connect to use the location for your Quarto installation:

; /etc/rstudio-connect/rstudio-connect.gcfg
[Quarto]
Enabled = true
Executable = "/opt/quarto/0.9.15/bin/quarto"

Unlike R and Python support, only a single Quarto installation is permitted at this time.

Note

Changing any of the Quarto configuration settings requires a restart of RStudio Connect.

Quarto support is only available when the Quarto.Enabled is enabled and the Quarto.Executable setting references a valid Quarto installation. RStudio Connect will warn at startup if Quarto is enabled without specifying an installation. Connect fails to start if Quarto is enabled but references an invalid installation.

A compatible version of Quarto is identified when content is deployed. That Quarto installation is used any time Quarto is needed for that content.

Quarto content may contain R and Python code chunks; when that content is deployed, compatible versions of R and Python are identified and used with Quarto anytime that content is run. Quarto support does not require either R or Python installations, but content that uses R or Python will succeed only if a compatible installation is available.