Skip to main content
v2026.11,986 entries · CC-BY 4.0

Direct comparison

Quarto vs R Markdown: Differences, When to Switch

Quarto vs R Markdown side by side: language support, YAML and chunk syntax changes, output formats, deprecation status and when to switch or stay.

Written and maintained by CASRAI Editorial Board

Last updated

How do Quarto and R Markdown compare side by side?

The table below compares Quarto and R Markdown across 11 dimensions, from language dependence to choose it when.

Side-by-side comparison

DimensionQuartoR Markdown
Language dependenceMulti-language and multi-engine (Knitr, Jupyter, Observable); no dependency or requirement for RFundamentally tied to R, although the R Markdown site notes that multiple languages including R, Python and SQL can be used
How R code runsUses Knitr to execute R code, as R Markdown doesUses Knitr
Chunk optionsWritten as #| comment lines at the top of the chunk; first-line options such as {r, echo = FALSE} still work but are not recommendedWritten in the chunk header, for example {r, echo = FALSE}
YAML output settingformat: key replaces output:; option names use hyphens (number-sections)output: key; option names use underscores (number_sections)
Format nameshtml, pdf, docxhtml_document, pdf_document, word_document
Output formatsHTML, PDF, MS Word, OpenDocument, ePub; Revealjs, PowerPoint and Beamer presentations; Markdown flavours such as GFM and CommonMark; project types include websites, books, dashboards and manuscriptsDozens of static and dynamic formats, including HTML, PDF, MS Word, Beamer, HTML5 slides, Tufte handouts, books, dashboards, Shiny apps, scientific articles and websites
R expressions in YAMLNeither !expr nor !r is supported in Quarto YAML (!expr works inside Knitr cells; !r fails validation)Not addressed on the R Markdown site
ExtensionsExtensions use Lua, not RNot addressed on the R Markdown site
Status and supportSome new features may only exist in QuartoQuarto FAQ: "R Markdown is not going away!" with no plans for deprecation
Moving an existing documentMost R Markdown documents and Jupyter notebooks render unmodified with Quarto; Jupyter .ipynb files are not executed by quarto render by defaultExisting .Rmd files need no change to keep working
Choose it whenYou want a non-R engine (Jupyter or Observable), need a Quarto-only featureYou have working .Rmd documents and no need for a Quarto-only feature: the Quarto FAQ says switching is not imperative

Ask CASRAI · free to try

Ask about Quarto vs R Markdown: Differences, When to Switch

2 free questions a day, no account.

An AI assistant for research: funder rules, compliance, methods and publishing. It links the sources behind its answers and labels answers that come from a web search.

Answers draw on CASRAI's guides and dictionary plus the federal and funder documents we index: Federal Register, Grants.gov, Regulations.gov and UKRI.

Works on this site and inside Claude, Cursor and the AI tools you already use.

Everything CASRAI publishes — this page, the dictionary, the guides and the news — stays open to read, with no account and no card.

Common questions

Common questions about Quarto vs R Markdown

Is R Markdown being replaced by Quarto?

+

No. The Quarto FAQ states that R Markdown is not going away and that there are no plans for deprecation. It also says switching is not imperative, though some new features may only exist in Quarto.

Can Quarto render my existing .Rmd files?

+

Usually. The Quarto FAQ says most R Markdown documents and Jupyter notebooks can be rendered unmodified with Quarto. Syntax that differs includes the output: key (format: in Quarto), underscores in option names (hyphens in Quarto), and R-style chunk options (#| comments in Quarto).

Does Quarto require R?

+

No. Quarto has no dependency or requirement for R and supports the Knitr, Jupyter and Observable engines. R Markdown is fundamentally tied to R.

Do Quarto and R Markdown execute R code the same way?

+

Yes. Like R Markdown, Quarto uses Knitr to execute R code.

Referenced across the research world

University of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logoUniversity of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logo
  • University of Cambridge logo
  • Columbia University logo
  • Crossref logo
  • University of Edinburgh logo
  • Harvard University logo
  • University of Oxford logo
  • Princeton University logo
  • Stanford School of Medicine logo
  • University College London logo
  • ORCID logo

View CASRAI adoption →