$ quarto --help
Usage: quarto
Version: 1.4.128
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
create-project [dir] - Create a project for rendering multiple documents
convert <input> - Convert documents to alternate representations.
pandoc [args...] - Run the version of Pandoc embedded within Quarto.
run [script] [args...] - Run a TypeScript, R, Python, or Lua script.
add <extension> - Add an extension to this folder or project
install [target...] - Installs an extension or global dependency.
publish [provider] [path] - Publish a document or project. Available providers include:
check [target] - Verify correct functioning of Quarto installation.
help [command] - Show this help or the help of a sub-command.Introduction to Quarto
Raukr 2023
June 13, 2023
Quarto …
…is a new, 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.
Knitr Engine
For R, Quarto still uses Knitr under the hood. Consequently, the vast majority of existing Rmd files can be rendered unmodified.
Note that the standard syntax for chunk options has changed (old syntax still works):
```{{r}}
#| echo: false
#| fig-cap: "Cars"
plot(cars)
```Knitr Engine
Jupyter Engine — ipynb
The Jupyter engine supports the use of Python, Julia, and any other language that has a Jupyter kernel.
Jupyter supports two input file formats:
- Traditional notebooks (
.ipynb) - Markdown w/ chunks (
.qmd)
Hello Jupyter: https://quarto.org/#hello-quarto
Jupyter Engine: ipynb
You can also render Jupyter notebooks (.ipynb files) directly. Note that in this case no execution occurs by default:
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]
```
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
