Quarto

How-to Guides and Useful Links

General

• Docs/first stop for getting started: https://quarto.org/
  • Extensions: https://quarto.org/docs/extensions/listing-revealjs.html
  • Presentations (in revealjs): https://quarto.org/docs/presentations/revealjs/
    
• Getting started
  • Getting Started with Quarto by Tom Mock (presented at rstudio conf 2022; works as of June 2023) here. Source code here.
• Misc
  • A Quarto tip a day by Mine Cetinkaya-Rundel: https://mine-cetinkaya-rundel.github.io/quarto-tip-a-day/

Cross-referencing

Sections https://quarto.org/docs/authoring/cross-references.html#sections

To reference a section, add a #sec- identifier to any heading. For example:

## Introduction {#sec-introduction}

See @sec-introduction for additional context.

Note that when using section cross-references, you will also need to enable the number-sections option (so that section numbering is visible to readers). For example:

---
title: "My Document"
number-sections: true
---

Installing extensions

Extensions (e.g. quarto-ext/fontawesome for icons) have to be installed with every new project (as far as I know). Quick tutorial for this: https://www.youtube.com/watch?v=u8EOVOjX13Y

Web

I found the following to be helpful in migrating my personal website from distill to Quarto:

• Code and content for andrewheiss.com
• Porting a distill blog to quarto by Danielle Navarro
• Customizing Your Quarto Website by Patrick Mobley
  • Patrick also provides a good list of examples/inspo.
• Customizing Quarto Websites by Sam Csik