Quarto: Introduction

Starts at:

Friday, 10:00

Objectives

💡 You know what Quarto is and what it can be used for.
💡 You can create a new Quarto file and render it to HTML.
💡 You understand the basics of Markdown syntax (text formatting, headings, lists, links).
💡 You can add a YAML header to a Quarto file to configure title, author, and output format.
💡 You can integrate Quarto with Git by tracking .qmd files and ignoring generated output files.

Tasks

In this session, you will work on the following tasks:

  1. Reading: Read the chapter(s) Quarto Documentation in the Version Control Book.
  2. Implementation: Try out the commands in the chapter.
  3. Exercises: Work on the exercises.

As always:

  1. Try out the commands of this session and play around with them.
  2. Check whether you have achieved the learning objectives.
  3. Ask questions!

Exercises

Getting started with Quarto

  1. Create a new empty Quarto file called my-project.qmd and save it in your my-project repository.
  2. Write a short introduction note to your my-project repository.
  3. Switch between Quarto’s visual and source mode.
  4. Render the file to HTML.

Markdown formatting

  1. Add a new entry to the my-project.qmd file.
  2. Format the text by applying at least three types of Markdown syntax.

YAML header

  1. Add a YAML header to your Quarto file.
  2. Include your name, a title, an output format (e.g., HTML), and a theme.

Slides

To export the slides to PDF, do the following:

  1. Toggle into Print View using the E key (or using the Navigation Menu).
  2. Open the in-browser print dialog (CTRL/CMD+P).
  3. Change the Destination setting to Save as PDF.
  4. Change the Layout to Landscape.
  5. Change the Margins to None.
  6. Enable the Background graphics option.
  7. Click Save.

Note: This feature has been confirmed to work in Google Chrome, Chromium as well as in Firefox.

Here’s what the Chrome print dialog would look like with these settings enabled:

These instructions were copied from the Quarto documentation (MIT License) and slightly modified.

Resources