You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/blog/posts/2025-xx-xx-R-package-release-1.5/index.qmd
+11-11Lines changed: 11 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ image-alt: "quarto R logo with 1.5.0 release text"
14
14
15
15
The quarto R package version 1.5.0 is here! This release focuses on making Quarto more flexible and powerful for R users with significant workflow improvements.
16
16
17
-
## What's New
17
+
## What's New {#whats-new}
18
18
19
19
Install the latest version from CRAN:
20
20
@@ -24,13 +24,13 @@ install.packages("quarto")
24
24
25
25
Major features in this release include:
26
26
27
-
-**Pass R values to Quarto metadata** - Set metadata programmatically based on computed values from knitr engine
28
-
-**Insert Markdown in HTML tables for Quarto processing** - Include Markdown content (equations, links, formatting) in HTML tables
29
-
-**Work with R scripts and Quarto** - Extract R code from Quarto documents or prepare R scripts for Quarto rendering
30
-
-**Build paths from Quarto Project** - Build paths relative to Quarto project root within R cells
31
-
-**Automate Quarto CLI from R** - New and improved wrappers around Quarto CLI features for easier automation
27
+
-[**Pass R values to Quarto metadata**](#pass-r-values-to-quarto-metadata) - Set metadata programmatically based on computed values from knitr engine
28
+
-[**Insert Markdown in HTML tables for Quarto processing**](#insert-markdown-in-html-tables) - Include Markdown content (equations, links, formatting) in HTML tables
29
+
-[**Work with R scripts and Quarto**](#work-with-r-scripts) - Extract R code from Quarto documents or prepare R scripts for Quarto rendering
30
+
-[**Build paths from Quarto Project**](#build-paths-from-project) - Build paths relative to Quarto project root within R cells
31
+
-[**Automate Quarto CLI from R**](#automate-quarto-cli) - New and improved wrappers around Quarto CLI features for easier automation
32
32
33
-
## Pass R Values to Quarto Metadata
33
+
## Pass R Values to Quarto Metadata {#pass-r-values-to-quarto-metadata}
34
34
35
35
Set metadata dynamically based on R computations with `write_yaml_metadata_block()`. For example, you could check a parameter value, and conditionally include content based on it:
36
36
@@ -99,7 +99,7 @@ This will mark the string to be double quoted in YAML, preserving the character
99
99
100
100
See more examples in the [dynamic metadata vignette](https://quarto-dev.github.io/quarto-r/articles/dynamic-metadata.html), including how to make parameters available as metadata for conditional content.
101
101
102
-
## Insert Markdown in HTML Tables for Quarto Processing
102
+
## Insert Markdown in HTML Tables for Quarto Processing {#insert-markdown-in-html-tables}
103
103
104
104
Quarto can [parse Markdown content in HTML tables](https://quarto.org/docs/authoring/tables.html#html-tables), enabling rich formatting like math equations, links, and text styling. The new `tbl_qmd_*()` functions make this powerful Quarto feature easier to use from R:
105
105
@@ -117,7 +117,7 @@ data.frame(
117
117
118
118
These helper functions wrap content in HTML spans with `data-qmd-base64` attributes that Quarto recognizes for Markdown processing. They work with any table package that supports raw HTML (knitr, kableExtra, DT). For content that only works in Quarto, use the `display` argument for graceful fallback. See more examples in the [Markdown in HTML tables vignette](https://quarto-dev.github.io/quarto-r/articles/markdown-html-tables.html), including comparisons of Markdown support in HTML tables across different packages.
119
119
120
-
## Work with R Scripts and Quarto
120
+
## Work with R Scripts and Quarto {#work-with-r-scripts}
121
121
122
122
### Extract R Code from Quarto Documents
123
123
@@ -161,7 +161,7 @@ This function adds a minimal spin-style preamble (using `#'` comments) that Quar
161
161
162
162
The preamble enables Quarto's [engine binding](https://quarto.org/docs/computations/execution-options.html#engine-binding) to properly process the script, allowing you to use R scripts as source documents alongside `.qmd` files. Learn more about working with R scripts in the [R scripts vignette](https://quarto-dev.github.io/quarto-r/articles/r-scripts.html).
163
163
164
-
## Build Paths from Quarto Project
164
+
## Build Paths from Quarto Project {#build-paths-from-project}
165
165
166
166
Quarto [sets environment variables](https://quarto.org/docs/advanced/environment-vars.html#variables-quarto-sets) during rendering that identify the project root, but knitr doesn't have direct access to this information by default. The new project navigation functions bridge this gap:
For more explicit control, consider using `here::i_am()` and `here::here()` as an alternative approach. Follow https://github.com/r-lib/here/issues/128 for improved support in next versions of `here`.
188
188
189
-
## Automate Quarto CLI from R
189
+
## Automate Quarto CLI from R {#automate-quarto-cli}
190
190
191
191
The quarto R package has always been designed as a comprehensive wrapper for the Quarto CLI, enabling seamless integration of Quarto into R workflows and pipelines. This release strengthens that foundation with improved wrappers and new helpers.
0 commit comments