Quarto Manuscripts

Overview

Quarto manuscript projects provide a framework for writing and publishing scholarly articles. A Quarto manuscript lets you:

Use one or more notebooks or .qmd documents as the source of content and computations, and then publish these computations alongside the manuscript, allowing readers to dive into your code.
Produce manuscripts in multiple formats (including LaTeX or MS Word formats required by journals), and give readers easy access to all of the formats through a manuscript website.

The output of a Quarto manuscript is a website (live example). The article itself appears as the content of the website, and can include all the elements common to scholarly writing like figures, tables, equations, cross references and citations. The website also makes available other formats (e.g. PDF, Docx) as well as links to all of the computations used to create the article.

A screenshot of the content area on the manuscript webpage. Content shows a title block including the article title, authors, and abstract, body text, and an image with a caption. — Article Content

On the right, you’ll see navigation: a table of contents for the article itself followed by links to Other Formats, Notebooks and Other Links.

Other Formats

These links allow a reader to download alternative formats of your article. In this example, there is an MS Word version that may be useful for a reviewer to provide feedback and a PDF version that uses the American Geophysical Union’s (AGU) template. Additionally, there is a MECA archive, a zip file that is designed to capture your article and its supporting documents into a single file suitable for sending to a publisher.

Notebooks

These are links to notebooks included in the manuscript. The “Article Notebook” is the notebook version of the article itself. In this example, “Data Screening” is a notebook from which a single cell is embedded in the article. Any other notebooks that are included in the project, even if they are not directly used in the article will also appear here.

When a reader visits any of these notebook links, they are served an HTML version of the notebook, allowing them to view the code and output without leaving their browser. In addition, a link to download the source code of the notebook is also provided.

Screenshot of the notebook view of data-screening.ipynb. The top of the page has a link Back to the Article and a button to Download Notebook. The content of the page includes some text and a cell displaying code. — HTML view of the Data Screening notebook

Get Started

Install Quarto

Manuscripts are a feature in the 1.4 release of Quarto. Before you get started, make sure you install the latest release version of Quarto.

_ Find your operating system in the table below

Highlights

Quarto 1.6 includes the following new features:

Support for brand.yml: Customize the appearance of your Quarto documents across formats with a single _brand.yml file.
Reveal JS updated to v5.1.0. Adds:
- Jump To Slide: a menu to quickly navigate between slides.
- Scroll View: a mode to view a presentation as a scrollable page.
{{< contents >}} shortcode: Flexibly rearrange the contents of your document, including moving the results of an executable code cell.
Landscape mode blocks: Use fenced divs with class .landscape to set portions of docx, pdf and typst documents to landscape. Thanks to @edvinsyk!

Release Notes

You can find release notes and installers for all platforms in the download page.

Choose Your Tool

You can author Quarto manuscripts in any tool or notebook editor. The tutorials below walk you through authoring Quarto manuscripts with a few common tools.

Choose your tool to start learning:

Jupyter

VS Code

RStudio