Quarto Quickstart
Quarto is an open-source scientific and technical publishing system built on Pandoc.
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 websitebook- Online bookmanuscript- Scientific manuscriptdefault- 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/