quickstart

Quarto Quickstart

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

Commands

• quarto <resource> <action> — Execute quarto commands

Installation

Linux (Debian/Ubuntu)

# Download latest release
wget https://github.com/quarto-dev/quarto-cli/releases/latest/download/quarto-linux-amd64.deb
sudo dpkg -i quarto-linux-amd64.deb

macOS

brew install quarto

Verify installation

quarto --version
quarto check

Basic Usage

Create a document

# Create a new document
quarto create document

# Or create directly
echo "---
title: My Document
---

# Hello World

This is my first Quarto document.
" > hello.qmd

Render a document

# Render to default format (HTML)
quarto render hello.qmd

# Render to specific format
quarto render hello.qmd --to pdf
quarto render hello.qmd --to docx

Preview with live reload

quarto preview hello.qmd

Convert formats

# Convert between .qmd and Jupyter notebook
quarto convert hello.qmd --to notebook
quarto convert hello.ipynb --to markdown

Project workflows

Create a project

quarto create project website mysite
cd mysite
quarto render

Project types

• website - Multi-page website
• book - Online book
• manuscript - Scientific manuscript
• default - Simple project

Key Features

• Code embedding: Python, R, Julia, JavaScript via Jupyter/Knitr/Observable
• Cross-references: Figures, tables, equations
• Citations: BibTeX, Zotero integration
• Multiple outputs: HTML, PDF, Word, ePub, Reveal.js slides
• Extensions: Custom templates and shortcodes

Resources

• Documentation: https://quarto.org/docs/
• Gallery: https://quarto.org/docs/gallery/
• Extensions: https://quarto.org/docs/extensions/