get_running_project_root: Get the root of the currently running Quarto project

In quarto: R Interface to 'Quarto' Markdown Publishing System

Get the root of the currently running Quarto project

Description

This function is to be used inside cells and will return the project root when doing quarto_render() by detecting Quarto project environment variables.

Usage

get_running_project_root()

Details

Quarto sets QUARTO_PROJECT_ROOT and QUARTO_PROJECT_DIR environment variables when executing commands within a Quarto project context (e.g., ⁠quarto render⁠, ⁠quarto preview⁠). This function detects their presence.

Note that this function will return NULL when running code interactively in an IDE (even within a Quarto project directory), as these specific environment variables are only set during Quarto command execution.

Value

Character Quarto project root path from set environment variables.

Use in Quarto document cells

This function is particularly useful in Quarto document cells where you want to get the project root path dynamically during rendering. Cell example:

```{r}`r ''`
 # Get the project root path
 project_root <- get_running_project_root()
```

See Also

• find_project_root() for finding the Quarto project root directory

• project_path() for constructing paths relative to the project root

Examples

## Not run: 
get_running_project_root()

## End(Not run)

quarto documentation built on Sept. 9, 2025, 5:52 p.m.