Quarto Codespaces

GitHub Codespaces and Dev Containers with Quarto, R, Python, and Julia, ready to render.

Ready to render

Open a browser tab and get a full Quarto toolchain: the Quarto CLI, R with renv, Python with uv and Jupyter, Julia with IJulia, TinyTeX for PDF, and headless Chromium for screenshots and Decktape. No local installation, no version drift, and the same container whether you run it in the cloud or on your own machine.

Purpose-built image

Open in GitHub Codespaces with the purpose-built image

Everything preinstalled, fastest to start.

Universal base image

Open in GitHub Codespaces with the universal base image

Lighter on your GitHub storage quota.

Use it as an image

The image is published to the GitHub Container registry and can be used as a base image, or run directly.

docker pull ghcr.io/mcanouil/quarto-codespaces:latest

release and prerelease images are built for linux/amd64 and linux/arm64, and rebuilt every Sunday so the toolchain never goes stale. See container images for the full tag list.

Use it as a Dev Container

Point your own .devcontainer/devcontainer.json at the image and pin the Quarto version you need:

{
  "name": "My Quarto project",
  "image": "ghcr.io/mcanouil/quarto-codespaces:latest",
  "remoteUser": "vscode",
  "features": {
    "ghcr.io/rocker-org/devcontainer-features/quarto-cli:1": {
      "version": "release"
    }
  }
}

What is inside

Quarto

The Quarto CLI with Pandoc, Dart Sass, Deno, and Typst, installed through the quarto-cli Dev Container feature so any version from 1.0 to prerelease can be selected.

R

R from r-rig with renv enabled, plus rmarkdown and languageserver, wired to the R and Air extensions with format-on-save.

Python

Python with shared libraries, jupyter and papermill, and uv for dependency management.

Julia

Julia on the release channel with IJulia, so the Jupyter engine can render Julia cells.

PDF and screenshots

TinyTeX for LaTeX output, and Chrome or Chromium with QUARTO_CHROMIUM preset for Typst previews, Mermaid diagrams, and Decktape.

Editor setup

The Quarto, Quarto Wizard, R, Air, Python, Pylance, and Jupyter extensions are installed and configured.

Next steps

  • Getting started walks through Codespaces, local Dev Containers, and using this repository as a template.
  • Reference documents every configuration, image tag, Dev Container feature, and the environment initialisation script.
Back to top