$ quarto --help
Usage: quarto
Version: 1.7.31
Description:
Quarto CLI
Options:
-h, --help - Show this help.
-V, --version - Show the version number for this program.
Commands:
render [input] [args...] - Render files or projects to various document types.
preview [file] [args...] - Render and preview a document or website project.
serve [input] - Serve a Shiny interactive document.
create [type] [commands...] - Create a Quarto project or extension
use <type> [target] - Automate document or project setup tasks.
add <extension> - Add an extension to this folder or project
update [target...] - Updates an extension or global dependency.
remove [target...] - Removes an extension.
convert <input> - Convert documents to alternate representations.
pandoc [args...] - Run the version of Pandoc embedded within Quarto.
typst [args...] - Run the version of Typst embedded within Quarto.
run [script] [args...] - Run a TypeScript, R, Python, or Lua script.
list <type> - Lists an extension or global dependency.
install [target...] - Installs a global dependency (TinyTex or Chromium).
uninstall [tool] - Removes an extension.
tools - Display the status of Quarto installed dependencies
publish [provider] [path] - Publish a document or project to a provider.
check [target] - Verify correct functioning of Quarto installation.
call - Access functions of Quarto subsystems such as its rendering engines.
help [command] - Show this help or the help of a sub-command.Introduction to Quarto
Raukr 2025
June 10, 2025
Quarto …
…is an open-source, scientific, and technical publishing system
- Computations: Python, R, Julia, Observable JS
- Markdown: Pandoc w/ many enhancements
- Output: Documents, presentations, websites, books, blogs
Artwork from “Hello, Quarto” keynote by Julia Lowndes and Mine Çetinkaya-Rundel, presented at RStudio Conference 2022. Illustrated by Allison Horst.
How to use ?
Integrates with other tools
Quarto Workflow
Code folding / copying
Code
```{r}
#| code-fold: true
library(ggplot2)
dat <- data.frame(cond = rep(c("A", "B"), each=10),
xvar = 1:20 + rnorm(20,sd=3),
yvar = 1:20 + rnorm(20,sd=3))
ggplot(dat, aes(x=xvar, y=yvar)) +
geom_point(shape=1) +
geom_smooth()
```
Cross References
Cross reference figures, tables, equations, sections, theorems, etc.
Using Plain markdown
Figure/Layout Panels
::: {layout="[[40,-20,40], [100]]"}
:::
Callouts
Work in various formats: HTML, PDF, MS Word, and ePub output
::: {.callout-note}
Note that there are five types of callouts, including:
`note`, `tip`, `warning`, `caution`, and `important`.
:::
Diagrams
Quarto has native support for embedding Mermaid and Graphviz diagrams.
```{mermaid}
%%| output-location: column
flowchart TD
A[Hard edge] --> B(Round edge)
B --> C{Decision}
C --> D[Result one]
C --> E[Result two]
```
Typst CSS for nice table output in PDF
New PDF rendering through Typst (https://typst.app)
format: typstThis is the quickest way to do PDF with already nice features !
# Producing a HTML Table with CSS styles
library(gt)
temps <- data.frame(
year = c(1920:1924),
Jan = c(40.6, 44.2, 37.5, 41.8, 39.3),
Jun = c(58.5, 58.7, 57.8, 52.7, 57.7)
)
nice_col <- scales::col_numeric(
colorspace::diverge_hcl(
n = 9, palette = "Green-Orange"
), domain = c(35, 62)
)
gt(temps) |>
data_color(columns = c(-year), fn = nice_col)
Easy Document Branding
_brand.yml
meta:
# Key identity information, name of the company, links to brand guidelines, etc.
color:
# Semantic colors, e.g. primary, secondary, success, warning, etc.
# color.palette: Named colors in the brand’s color palette.
typography:
# Font family, weight, style, color, and line height for key elements,
# e.g. base, headings and monospace text.
# typography.fonts: Font definitions for Google, remote or bundled fonts.
logo:
# Files or links to the brand’s logo at various sizes.
defaults:
# Additional context-specific settings beyond the basic brand colors and typography.
# These could be options, for example, that are used by Bootstrap in Quarto or Shiny. Works for HTML and PDF through Typst.
YAML Intelligence
- YAML code completion for config files, front matter, and chunk options
- Real-time diagnostics and clear errors at render time for invalid YAML
Completion
Diagnostics
RStudio IDE
Current release of RStudio IDE has Quarto tooling on-par w/ R Markdown tooling
Jupyter Lab