Quarto

Quarto is an open-source scientific and technical publishing system for creating reproducible documents that combine narrative and executable code.

Positron enhances how you can use Quarto in several important ways:

Quarto works out of the box in Positron. The Quarto CLI is bundled in Positron, and the Quarto extension is included as a bootstrapped extension.
Features such as statement execution work seamlessly in Positron’s Console, and Positron supports integrated rendering and preview of Quarto documents.
Positron provides rich UI via custom action bars to preview your Quarto document, control rendering behavior, and switch between source and visual mode,

A Quarto document in Positron, with narrative, executable code chunks, and the rendered preview in Positron’s integrated Viewer Pane.

Learn more in the Quarto documentation about getting started with Quarto and Positron, or the details of using Positron as a tool for working with Quarto.

Note

Quarto’s visual editor currently has limited support in Positron. It is a great fit for rich text authoring, but statement execution and other language features are not yet supported. Consider switching to source mode when you need such features, and follow along on GitHub for updates on this support.

Support for R Markdown

Quarto provides Positron’s support for R Markdown; there are no specialized IDE features for R Markdown other than those provided by Quarto. Some advanced .Rmd features like using params are not supported for interactive use. Positron’s Command Palette does provide the command R: Render Document With R Markdown, which renders an .Rmd file using the R package rmarkdown instead of Quarto; this does support all .Rmd features but does not automatically preview the rendered output.

Using the Quarto extension

The Quarto extension is included as a bootstrapped extension in Positron. This means that it will behave just like you installed it yourself; this extension will update automatically when a new version is available on Open VSX and it can be uninstalled if desired.

Managing Quarto installations

Positron bundles a version of the Quarto CLI, but you can also use a version of the Quarto CLI that you have installed yourself. This should typically work automatically, but you can manage exactly which Quarto to use via the quarto.path setting. Check the bottom status bar to see which version of Quarto is being used currently.¹

Footnotes

If you change the version of Quarto you are using, you will need to restart Positron to see the status bar update.↩︎