miawege / awesome-quarto

A curated list of Quarto talks, tools, examples & articles! Contributions welcome!

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.

---

Contributions of any kind are 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
  • Docx Documents
  • Multiple formats
  • Repository templates
• Real-life examples
  • Presentations formats
  • Websites formats
  • Book formats
  • Other formats
• Follow
  • Official
  • Community

Featured (new releases)

• Quarto for the Python User - A blog post introducing Quarto to Python user for creating reports.
• add-code-files - This extension filter provides alternative syntax for adding contents from external files and works with code-fold.
• hide-comment - This extension filter provides comment-directive to hide comment from code chunk in the rendered document.
• nameref - This extension filter allows to use name (section name, fig-name or table-name) for cross-referencing the document sections, tables, figures instead of number.
• material-icons - This extension provides a shortcode to use Google's Material Design Icons for html and revealjs formats.
• brief - A KOMA-script based template to create German DIN 5008 compliant PDF letters.
• bookup - A Quarto extension template providing light and dark themes to be used for html documents, books and websites.
• compact - A template to create compact PDF documents such as short reports, homework assignments, etc.

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).
• Workshop: Quarto, a library to run them all? - Workshop at RSECon'22, led by Carlos Cámara, James Tripp and Cagatay Turkay (materials: https://github.com/WarwickCIM/quarto-workshop).
• Tutorial: Creating your personal website using Quarto - A step-by-step guide for setting up a personal website using Quarto by Samantha Csik.
• Tutorial: Customizing Quarto Websites - Make your website stand out using SASS & CSS - Slides by Samantha Csik about using SASS and CSS to customise HTM Quarto website (materials: https://github.com/UCSB-MEDS/customizing-quarto-websites).
• Workshop: Quartaki — 6 hour introduction to Quarto - Using R and RStudio by Athanasia Mo Mowinckel covering basic markdown, html reports, citation & cross-refs, pdf and journal templates and Reveal.js presentations.
• Workshop: Mi primer blog con Quarto - A workshop in Spanish by Pedro J. Pérez to create a blog with Quarto (materials: https://github.com/perezp44/taller.primer.blog).

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.
• 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.
• Making Slides in Quarto with Reveal.js - A blog post about making slides in Quarto with Reveal.js and how to use emojis or customise the slides by Meghan Hall.
• A beginner's guide to using Observable JavaScript, R, and Python with Quarto - This article shows you how to set up a Quarto document to use Observable JavaScript, including how to pass data from R or Python to an Observable code chunk.
• Six Productivity Hacks for Quarto - A blog post showing six tips from the re-use content across documents, the insertion of Pandoc divs and spans to continuous deployment with GitHub Actions.
• Let's make maps with bertin.js in Quarto - A HTML document showing how to draw maps with bertin.js in Quarto.
• How to add some personality to your Quarto Blog - A blog post sharing some of the added features and tweaks users can make on top of the standard blog templates to inject some personality into their blog.
• Use R to Generate a Quarto Blogpost - A blog post about using R to generate Quarto blog post by Tom Mock.
• Adding Subscriptions to a Quarto Site - A blog post about how to add a subscription form to your Quarto blog.
• I'm an R user: Quarto or R Markdown? - A blog post comparing Quarto and R Markdown from an R user perspective by Jumping Rivers.
• Quarto for the Python User - A blog post introducing Quarto to Python user for creating reports.

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 - RStudio Meetup: Welcome to Quarto 2-hour Workshop by Tom Mock (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.
• Building a Blog with Quarto - RStudio Meetup: Building a Blog with Quarto by Isabella Velásquez (materials: https://ivelasq.quarto.pub/building-a-blog-with-quarto/).
• Beautiful Reports and Presentations with Quarto - RStudio Meetup: Beautiful Reports and Presentations with Quarto by Tom Mock (materials: https://github.com/jthomasmock/quarto-reporting).
• Introduction to Quarto - R-Ladies St. Louis: Introduction to Quarto by Isabella Velásquez (materials: https://github.com/ivelasq/2022-10-27_intro-to-quarto).
• Quarto YouTube Playlist - A YouTube playlist of videos about Quarto and Pandoc by Eli Holmes.
• Create your Data Science Portfolio with Quarto - In this video by Deepsha Menghani, learn how you can easily create a Data Science Portfolio website and deploy it instantly with the help of Quarto (materials: https://deepshamenghani.quarto.pub/portfolio-with-quarto-workshop/#/title-slide).
• A Coffee with Quarto and Neovim - A YouTube playlist showing you how to use Quarto in Neovim by Jannik Buhr.

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.
• Scrivener - Quarto support to Scrivener via Scrivener Template.
• RStudio - RStudio IDE by Posit PBC natively supports 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 containing an RStudio Addin to insert some useful divs and classes into your Quarto revealjs 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.
• matrix BOT - A little bot for the matrix-network that listens for some Quarto files and returns the PDF into the matrix channel.

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.
• Quarto Devcontainer Feature - Add Quarto CLI to your Development Containers as a feature.

Extensions

• 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.
• 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 revealjs presentations.
• iconify - This extension provides shortcodes to Iconify icons library (HTML-based format only).
• 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.
• qrcode - This extension provides a shortcode to support QR codes via QRCode.js (HTML-based format only).
• animate - This extension provides support and shortcode to animate.css (HTML-based format only).
• elevator - This extension provides support and shortcode to Elevator.js.
• code-visibility - This extension implements some directives for filtering code and stream output included within a document.
• roughnotation - An extension that uses the roughnotation JavaScript library to add animated annotations to revealjs documents.
• attribution - A Quarto extension that brings Reveal.js plugin for displaying attribution text sideways along the right edge of the viewport.
• shinylive - This extension lets you embed Shinylive (Shiny for Python) applications in a Quarto document.
• pointer - A Quarto extension that brings a very simple Reveal.js plugin that adds support for switching the cursor to a 'pointer' style element while presenting.
• social-embeds - A Quarto extension that provides shortcodes to embed content from across the web into HTML-based documents.
• bsicons - This extension provides shortcodes to Bootstrap icons library (HTML-based format only).
• collapse-callout - A filter that provides global options to make the Callout Blocks collapsible (HTML-based format only).
• include-code-files - Include code from files using code cells option/attribute.
• designmode - A quarto extension, adding a toggle for designMode in html and revealjs formats.
• confetti - This extension uses canvas-confetti a JavaScript library to send some confetti in your revealjs presentation.
• code-insertion - This extension enables code insertion immediately before and/or after a post/page for website and blog projects.
• snow - This extension adds falling snowflakes in html and revealjs formats.
• swissbiopics - This extension adds shortcode to embed SwissBioPics library of interactive biological images in html and revealjs formats.
• chord-sheet - This extension provides support for rendering chord sheets in html and revealjs formats.
• inadsense - This extension provides shortcode for inserting Google Adsense ads in html and revealjs formats.
• forms - This extension provides shortcode for rendering forms in html and revealjs formats.
• rev-history - This extension provides a shortcode for rendering revision history table with content pulled from git tags.
• verticator - This extension provides indicators to show the amount of slides in a vertical stack in revealjs formats.
• multibib - This extension provides support for multiple bibliographies.
• stata-facade - A Quarto extension that hides the evidence of faking Stata dynamic content with Python code blocks and Stata cell magic.
• authors-block - This extension brings the capability to add an author-related header block when rendering docx documents with Quarto.
• line-highlight - Quarto Extension to implement source code line highlighting and output line highlighting for html documents.
• hedgedoc-slides - A LUA filter to convert revealjs presentations to HedgeDoc presentations.
• Sverto - Sverto is an extension for Quarto that lets you seamlessly write and include Svelte components, like charts and other visuals, in your Quarto website.
• collapse-social-embeds - Quarto extension to provide collapsible option to social-embeds extension.
• reveal-header - A Quarto extension to add a header to revealjs slides as the footer.
• downloadthis - This extension shortcode provides support for adding download buttons to download image/pdf/txt/csv files.
• add-code-files - This extension filter provides alternative syntax for adding contents from external files and works with code-fold.
• hide-comment - This extension filter provides comment-directive to hide comment from code chunk in the rendered document.
• nameref - This extension filter allows to use name (section name, fig-name or table-name) for cross-referencing the document sections, tables, figures instead of number.
• material-icons - This extension provides a shortcode to use Google's Material Design Icons for html and revealjs formats.

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.
• sportrxiv - Template for SportRxiv preprints.
• Computo - Template for Computo journal.
• asm - Template for the American Society for Microbiology, based on the mSystems LaTeX template.
• asce - Template for American Society of Civil Engineers journals and conference proceedings.
• iop - Template for Institute of Physics journal.

Presentations

• Storybook - A medieval like template for Quarto revealjs presentation.
• Coeos - A dark grey / white based template for Quarto revealjs presentation.
• R-Ladies - R-Ladies (@rladies) template for Quarto revealjs presentation.
• Onyxia - Onyxia template for Quarto revealjs presentation.
• Organization Boilerplate Template - Organisation Boilerplate Template to be cloned and modified to fit your needs for Quarto revealjs presentation.
• Blackboard - A blackboard like template for Quarto revealjs presentation.
• nes - A Nes template for Quarto revealjs presentation.
• insper - A "insper" template for Quarto revealjs presentation.
• metropolis-theme - Opinionated port of the Metropolis template for Quarto revealjs presentation.
• letterbox - A Quarto extension for authoring letterbox styled presentations using revealjs formats.
• kakashi - The kakashi template extension for Quarto revealjs slides is a theme with clean look and a colour-blind friendly palette.

HTML Documents

• Sketchy HTML - A template for Quarto to create sketchy looking HTML documents.
• lcars - An LCARS template for Quarto html documents.
• bookup - A Quarto extension template providing light and dark themes to be used for html documents, books and websites.

PDF Documents

• letter - An opinionated template to create letter PDF documents.
• hikmah - An opinionated template to create PDF documents with support to biblatex-chicago and more.
• titlepage - This extension template brings several title pages for your PDF documents from one yaml option.
• simple-article - This is a Quarto template that assists you in creating a simple, journal article-like document.
• qletter - An opinionated template to create letter PDF documents.
• nastatement - A template for creating a statement PDF letter.
• naletter - An opinionated template to create letter PDF documents.
• nanotes - A template for creating handout PDF notes.
• Monash letter - A Monash University template to create letter PDF documents.
• Monash memo - A Monash University template to create memo PDF documents.
• Monash wp - A Monash University template to create working paper PDF documents.
• Monash report - A Monash University template to create report PDF documents.
• Monash thesis - A Monash University template to create thesis PDF documents.
• brief - A KOMA-script based template to create German DIN 5008 compliant PDF letters.
• compact - A template to create compact PDF documents such as short reports, homework assignments, etc.

Docx Documents

• lettre-gouv - A Quarto extension template for French governmental documents.

Multiple formats

• inrae - INRAE extension template with several formats (html and pdf).
• tufte - A Quarto extension template for Tufte-style book (html and pdf).

Repository templates

• NOAA Quarto Simple Website - NOAA simple is a repository template for a simple Quarto website that looks like a "book".
• quarto-revealjs-inverse - The goal of this repository is to provide an example of how to create a inverse class to use in revealjs slides.
• quarto-revealjs-seasons - This is an example of how to create a revealjs theme with multiple styles.

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.
• Quarto: Create Beautiful Documents with R, Python, Julia and Observable (Runapp 2022 talk) - See slides here.
• Iframes Gallery - A gallery of iframes that could be used in Quarto revealjs format.

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.
• AffCom Lab Website - A research lab Quarto Blog/website using custom listing pages for people and publications.
• Quantum Jitter - A Quarto website / blog with a custom theme (adapted from flatly / darkly), day / night landing page and a novel 404 page.
• Andrew Heiss's website - Andrew Heiss's website with custom EJS format, footer, 404 page, (S)CSS, and many more customisations.
• Ella Kaye's website - Ella Kaye's website with Bootstrap Grid card home page layout, CSS animation in navigation bar, and light/dark mode.

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.
• Python for Data Analysis, 3E - "Python for Data Analysis" book thrid edition (see https://wesmckinney.com/book/).

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; Mastodon: @[email protected]).
• Carlos Scheidegger (@cscheid) - Member of Quarto core team (Twitter: @scheidegger; Mastodon: @[email protected]).
• 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; Mastodon: @[email protected]).

Community

• Mickaël Canouil (@mcanouil) - Maintainer of Awesome Quarto list (Twitter: @MickaelCanouil; Mastodon: @[email protected]).

Who else should we be following!?

Contributing

Thanks goes to these contributors!