Awesome Quarto

The most up to date curated list of Quarto® docs, talks, tools, examples & articles the internet has to offer.

Quarto® is an open-source scientific and technical publishing system built on Pandoc.

• Create dynamic content with Python, R, Julia, and Observable.
• Author documents as plain text markdown or Jupyter notebooks.
• Publish high-quality articles, reports, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more.
• Author with scientific markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more.

Contributions of any kind welcome, just follow the guidelines by either:

• Filling a suggestion issue (easier).
• Opening a pull request.

Contents

• Featured (new releases)
• Official documentation & quickstarts
• Tutorials & workshops
• Blog posts
• Talks and videos
• Supported editors
• Libraries/Packages/Scripts
• Continuous integration / Continuous deployment
• Extensions
• Templates
  • Journals
  • Presentations
  • HTML Documents
  • PDF Documents
• Real life examples
  • Presentations formats
  • Websites formats
  • Book formats
  • Other formats
• Follow
  • Official
  • Community

Featured (new releases)

• Heads up! Quarto is here to stay - A post providing an overview of Quarto, focussing on weaving together R and Python. Also provides help for Apple Silicon Mac users that run into trouble.
• Slidecraft 101: Colors and Fonts - A blog post about "The art of putting together slides that are functional and aesthetically pleasing" using Quarto presentation format by Emil Hvitfeldt.
• ohq2quarto - A Rust-based command line utility to turn any ObservableHQ notebook into a Quarto project.
• Quartize - A Chrome extension to transform any ObservableHQ notebook into a list of downloadable FileAttachments and an in-page Quarto source document.
• RStudio & VSCode snippets - RStudio & VSCode snippets to ease typesetting with Quarto.
• Quarto Website with GitHub Actions - Publih a Quarto website automatically every time it is updated via GitHub Actions.
• nutshell - This extension provides a filter to embed Nutshell in HTM-based documents.
• section-bibliographies - This extension provides a filter to create a separate bibliography for each section or chapter.
• video - This extension provides shortcodes to embed videos in HTML-based documents.
• letter - A template for Quarto to create letter PDF documents.
• Introduction to Data Analysis with R - Introductory course with videos and lecture scripts as a quarto book format.
• Tom Mock (@jthomasmock) - Customer Enablement & Quarto Product Manager (twitter: @thomas_mock).
• Mickaël Canouil (@mcanouil) - Maintainer of Awesome Quarto list (twitter: @MickaelCanouil).

Official documentation & quickstarts

• Documentation: Quarto documentation - Official Quarto Documentation.
• GitHub: Quarto GitHub repository - Official Quarto GitHub repository.
• Tutorial: Hello, Quarto - Official "Hello, Quarto" tutorial.
• Tutorial: Computations - Official "Computations" tutorial.
• Tutorial: Authoring - Official "Authoring" tutorial.
• Service: Quarto Pub - Create documents, websites, presentations, books, and blogs in Quarto, then securely publish them to the web with the Quarto CLI, the easiest way to publish and share on the web.

Tutorials & workshops

• Tutorial: The ultimate guide to starting a Quarto blog - An in-depth guide on how to start blogging with Quarto.
• Tutorial: Creating a blog with Quarto in 10 steps - A blog post introducing a new Quarto blog and the steps to create your own blog with Quarto.
• Tutorial: Making shareable docs with Quarto - A tutorial to make website with Quarto.
• Workshop: From R Markdown to Quarto - A workshop for those who want to take their R Markdown skills and expertise and apply them in Quarto, the next generation of R Markdown.
• Workshop: Getting started with Quarto - "Get started with Quarto" workshop materials for rstudio::conf(2022).

Blog posts

• We don't talk about Quarto - A blog post introducing to Quarto publishing software by Alison Presmanes Hill.
• Quarto tip a day - A website made with Quarto highlighting a tip for Quarto every day as a blog post.
• Announcing Quarto, a new scientific and technical publishing system - Blog post by J.J. Allaire announcing the launch of Quarto, a new open-source scientific and technical publishing system.
• Interactive Molecular Content - A blog post showing how to embed interactive content (i.e., molecular visualisation) in webpages with Quarto using Bokeh, 3DMol.js and NGL.
• Heads up! Quarto is here to stay - A post providing an overview of Quarto, focussing on weaving together R and Python. Also provides help for Apple Silicon Mac users that run into trouble.
• Slidecraft 101: Colors and Fonts - A blog post about "The art of putting together slides that are functional and aesthetically pleasing" using Quarto presentation format by Emil Hvitfeldt.

Talks and videos

• Reproducible authoring with Quarto - 2022 Toronto Workshop on Reproducibility with Mine Çetinkaya-Rundel (slides: https://mine-cetinkaya-rundel.github.io/2022-repro-toronto/).
• Reproducible Publications with Julia and Quarto - JuliaCon 2022 with J.J. Allaire (slides: https://jjallaire.github.io/quarto-juliacon-2022).
• A Conversation about Quarto - Openscapes Community Talk: Hello Quarto!
• Tutorial: How to style your Quarto blog without knowing a lot of HTML/CSS - This is a video tutorial on styling your Quarto blog even if you lack a strong foundation of HTML/CSS.
• Workshop: Welcome to Quarto 2-hour Workshop - Getting Started with Quarto in a 2-hour workshop led by Tom Mock, RStudio (slides: https://jthomasmock.github.io/quarto-2hr-webinar/).
• Quarto for the Curious - A Quarto overview given by Tom Mock at RStudio::conf(2022) (materials: https://thomasmock.quarto.pub/quarto-curious/).
• Hello Quarto: Share • Collaborate • Teach • Reimagine - Keynote by Mine Çetinkaya-Rundel & Julia Stewart Lowndes highlighting how they leverage Quarto in open-science at RStudio::conf(2022) (materials: https://github.com/mine-cetinkaya-rundel/hello-quarto).
• Websites & Books & Blogs, oh my! Creating Rich Content with Quarto - Talk by Devin Pastoor at RStudio::conf(2022) showing some of the formats available in Quarto and how it is easy to focus on contents while Quarto takes care of the rest.
• Literate Programming With Jupyter Notebooks and Quarto - Talk by Hamel Husain at RStudio::conf(2022) describing the integration between Nbdev and Quarto (materials: https://github.com/fastai/nbdev-demo).
• These are a few of my favorite things - Talk by Tracy Teal at RStudio::conf(2022) highlighting some of the features of Quarto presentation, such as multiple columns, speaker notes and mode, transitions, etc.

Supported editors

• Emacs - Emacs mode for Quarto.
• Neovim - Neovim tools to work with Quarto.
• Sublime Text - Sublime Text plugin to work with Quarto.
• Vim - Vim plugin to work with Quarto.
• Visual Studio Code - Visual Studio Code extension for Quarto.

Libraries/Packages/Scripts

• Julia - Julia interface package to Quarto CLI.
• Python - Python interface package to Quarto CLI.
• R - R interface package to Quarto CLI.
• ecodown - Turn R package documentation pkgdown website into a Quarto website.
• Simulate colorblindeness - Observable widget to simulate colorblindness for your whole document.
• quartostamp - An R package An R package containing an RStudio Addin to insert some useful divs and classes into your Quarto reveal.js document.
• ohq2quarto - A Rust-based command line utility to turn any ObservableHQ notebook into a Quarto project.
• Quartize - A Chrome extension to transform any ObservableHQ notebook into a list of downloadable FileAttachments and an in-page Quarto source document.
• RStudio & VSCode snippets - RStudio & VSCode snippets to ease typesetting with Quarto.

Continuous integration / Continuous deployment

• Quarto GitHub Actions - Official Quarto GitHub Actions allowing to setup, render, and deploy Quarto projects via GitHub Actions.
• Quarto Website with GitHub Actions - Publih a Quarto website automatically every time it is updated via GitHub Actions.

Extensions

• code-filename - An extension that enables you to add a filename attribute to code blocks, which is useful if you are documenting the contents of a file and want to be especially clear about the name of the file the code is associated with.
• fancy-text - A very simple shortcode extension that adds shortcodes for outputing nicely formatted versions of fancy strings (such as LaTeX and BibTeX).
• fontawesome - This extension provides support including free icons provided by Font Awesome.
• grouped-tabsets - This extension provides support for "grouped" tabsets (HTML-based format only).
• latex-environment - This extension enables divs to be output as a custom environment in LaTeX.
• lightbox - An extension that uses the GLightbox JavaScript library to add lightbox styling and behavior to images (HTML-based format only).
• lordicon - This extension provides support for Lordicon icons library (HTML-based format only).
• academicons - This extension provides support for academicons icons library (HTML-based format only).
• molstar - This extension provides shortcodes for molstar, a tool to display macro-molecules such as proteins as well as molecular dynamics trajectories in an interactive viewer.
• abstract-section - This extension allows to write an abstract anywhere in the main text and moves it to the metadata.
• reveal-auto-agenda - This extension automatically creates agenda/outline slides for your Quarto reveal.js presentations.
• youtube - This extension provides shortcodes to embed YouTube videos.
• iconify - This extension provides shortcodes to Iconify icons library (HTML-based format only).
• twitter - This extension provides shortcodes to embed tweets in HTML-based documents.
• social-share - This extension allows to add buttons to share HTML-based documents on various social media platforms.
• nutshell - This extension provides a filter to embed Nutshell in HTML-based documents.
• section-bibliographies - This extension provides a filter to create a separate bibliography for each section or chapter.
• video - This extension provides shortcodes to embed videos in HTML-based documents.

Templates

Journals

• acm - Template for Association of Computing Machinery.
• acs - Template for American Chemical Society.
• biophysical-journal - Template for Biophysical journal.
• elsevier - Template for Elsevier Journals.
• jasa - Template for American Statistical Association Journals.
• jss - Template for Journal of Statistical Software.
• plos - Template for Public Library of Science.
• arXiv - Template for arXiv-style preprints.
• quarto-tandf - Template for Taylor and Francis.

Presentations

• Storybook - A medieval like template for Quarto reveal.js presentation.
• Xoeos - A dark grey / white based template for Quarto reveal.js presentation.
• R-Ladies - R-Ladies (@rladies) template for Quarto reveal.js presentation.
• Onyxia - Onyxia template for Quarto reveal.js presentation.
• Organization Boilerplate Template - Organisation Boilerplate Template to be cloned and modified to fit your needs for Quarto reveal.js presentation.
• Blackboard - A blackboard like template for Quarto reveal.js presentation.

HTML Documents

• Sketchy HTML - A template for Quarto to create sketchy looking HTML documents.

PDF Documents

• letter - A template for Quarto to create letter PDF documents.
• hikmah - An opinionated template for Quarto to create PDF documents with support to biblatex-chicago and more.

Real life examples

Presentations formats

• Advanced Introduction to R (French) - See slides here.
• Streamlining with R - See slides here.
• An educator's perspective of the tidyverse - See slides here.
• An anthology of experimental designs - See slides here.
• The untold story of palmerpenguins - See slides here.
• Outrageously efficient EDA - See slides here.
• Improvements in textrecipes - See slides here.

Websites formats

• quarto.org - The Quarto documentation website.
• rlille.fr - The R Lille (R User Group) website using Quarto.
• R-Manuals - R Manuals rewritten with Quarto.
• Quarto tip a day - Website/blog highlighting a tip for Quarto every day.
• Documentation website from Jupyter Notebook - Quarto used to generate a website from a Jupyter notebook containing Python module documentation.
• Program Evaluation for Public Service (course) - Website for graduate-level course on program evaluation and causal inference using R, built with Quarto.
• Bioconductor Community Blog - A Quarto Blog for Bioconductor community.
• R for Social Scientists workshop - A Quarto website for a workshop which includes Quarto Reveal JS presentations embedded in it.

Book formats

• R for Data Science, 2E - "R for Data Science" book second edition (see https://r4ds.hadley.nz/).
• R Packages, 2E - "R Packages" book second edition (see https://r-pkgs.org/).
• mlr3book - Book on the ml3r packages ecosystem (see https://mlr3book.mlr-org.com/).
• Introduction to Data Analysis with R - Introductory course with videos and lecture scripts as a Quarto book format.

Other formats

Follow

Official

• @quarto-dev - GitHub organisation containing Quarto CLI, IDE plugins/extension, etc.
• @quarto-ext - GitHub organisation containing extensions developed/maintained by Quarto's team.
• @quarto-journals - GitHub organisation containing journals templates developed/maintained by Quarto's team.
• J.J. Allaire (@jjallaire) - Member of Quarto core team (Twitter: @fly_upside_down).
• Christophe Dervieux (@cderv) - Member of Quarto core team (Twitter: @chrisderv).
• Carlos Scheidegger (@cscheid) - Member of Quarto core team (Twitter: @scheidegger).
• Charles Teague (@dragonstyle) - Member of Quarto core team (Twitter: @dragonstyle).
• Yihui Xie (@yihui) - Member of Quarto core team (Twitter: @xieyihui).
• Tom Mock (@jthomasmock) - Customer Enablement & Quarto Product Manager (Twitter: @thomas_mock).

Community

• Mickaël Canouil (@mcanouil) - Maintainer of Awesome Quarto list (Twitter: @MickaelCanouil).

Who else should we be following!?

Contributing

Thanks goes to these contributors!