Quarto#
Quarto is an open-source scientific and technical publishing system built on Pandoc.
Content authored using Quarto can be published to RStudio Connect. Quarto must be installed on your system and configured in RStudio Connect prior to its use. Contact your RStudio Connect administrator if Quarto support is not available. Information about setting up Quarto in RStudio Connect is available in the Quarto chapter of the Admin Guide
Important
Quarto development is active and ongoing. RStudio Connect includes support for Quarto content. Please let your Customer Success representative know about your experience using Quarto with Connect.
For information about authoring Quarto content, see the Quarto Guide.
Publishing Quarto Content#
There are multiple ways to publish Quarto content to RStudio Connect. See the linked documentation for each method for more on how to use it to publish Quarto content.
| Tool | Method | Supported Runtimes |
|---|---|---|
| RStudio IDE | Push-button publishing | knitr, jupyter |
The quarto R package |
quarto_publish_[site|app|doc]() |
knitr, jupyter |
The rsconnect R package |
deployApp(quarto = QUARTO_PATH),writeManifest(quarto = QUARTO_PATH) |
knitr, jupyter |
The rsconnect-python CLI |
rsconnect deploy quarto,rsconnect write-manifest quarto |
jupyter |
The rsconnect-python CLI |
rsconnect deploy manifest |
knitr, jupyter |
Note
If your Quarto content contains R code, you cannot use the
rsconnect-python CLI's rsconnect deploy quarto function. You can still
use rsconnect deploy manifest to deploy content for which a
manifest has already been
generated.
Quarto Feature Support#
Quarto content supports executable code in multiple languages, and supports interactivity through a number of technologies.
RStudio Connect supports most of Quarto's capabilities, including:
- Rendering R, Python, and Observable JS code.
- Running interactives written with
Shiny,
ObservableJS, and
R
htmlwidgets. - Rendering Quarto projects, documents, websites, and books.
RStudio Connect doesn't support the following Quarto capabilities:
- Rendering Julia code chunks.
- Running interactives written with Jupyter Widgets.