quarto_create_project: Create a quarto project

In quarto-dev/quarto-r: R Interface to 'Quarto' Markdown Publishing System

Create a quarto project

Description

This function calls ⁠quarto create project <type> <name>⁠. It creates a new directory with the project name, inside the requested parent directory, and adds some starter files that are appropriate to the project type.

Usage

quarto_create_project(
  name,
  type = "default",
  dir = ".",
  no_prompt = FALSE,
  quiet = FALSE,
  quarto_args = NULL
)

Arguments

name	The name of the project and the directory that will be created.
type	The type of project to create. As of Quarto 1.4, it can be one of default, website, blog, book, manuscript, confluence.
dir	The directory in which to create the new Quarto project, i.e. the parent directory.
no_prompt	Do not prompt to approve the creation of the new project folder.
quiet	Suppress warning and other messages, from R and also Quarto CLI (i.e --quiet is passed as command line). quarto.quiet R option or R_QUARTO_QUIET environment variable can be used to globally override a function call (This can be useful to debug tool that calls ⁠quarto_*⁠ functions directly). On Github Actions, it will always be quiet = FALSE.
quarto_args	Character vector of other quarto CLI arguments to append to the Quarto command executed by this function. This is mainly intended for advanced usage and useful for CLI arguments which are not yet mirrored in a dedicated parameter of this R function. See ⁠quarto render --help⁠ for options.

Quarto version required

This function requires Quarto 1.4 or higher. Use quarto_version() to see your current Quarto version.

See Also

Quarto documentation on Quarto projects

Examples

## Not run: 
quarto_create_project("my-first-quarto-project", dir = "~/tmp")

## End(Not run)

quarto-dev/quarto-r documentation built on June 14, 2025, 3:45 a.m.