How I Set Up This Website with Quarto

Quarto
Tools
Meta
A walkthrough of the tools and structure I used to build my academic website, deployed free on GitHub Pages.
Published

May 15, 2026

Why Quarto?

Quarto lets me write in .qmd files — a superset of Markdown that supports R, Python, and Julia code blocks that actually execute. That means I can include live analysis in posts without copy-pasting outputs.

The Structure

The site is organized as…

my-website/
├── _quarto.yml      # Site config
├── index.qmd        # Homepage
├── publications.qmd
├── projects/
├── posts/           # Blog posts live here
├── teaching.qmd
└── assets/

Deploying to GitHub Pages

# One-time setup
quarto publish gh-pages

# Subsequent updates
git add . && git commit -m "Update"
quarto publish gh-pages

That’s it — Quarto handles building and pushing to the gh-pages branch automatically. Your site will be live at https://yourusername.github.io.