📘 👨‍💻 📄 index.qmd Templates for Quarto Projects

programming

Quarto

YAML

article

The index.qmd file is usually the main entry point of a Quarto project.

Author

Blog do Marcellini

Published

June 29, 2025

← Back to the Programming Reading Guide 👨‍💻

← Back to the Quarto Section 📄

← Back to the Programming Section 👨‍💻

1 📘 👨‍💻 📄 index.qmd Templates for Quarto Projects

1.1 Introduction

The index.qmd file is usually the main entry point of a Quarto project.
It can be used as the home page of a website or a book, and its YAML header defines the global title, formatting, and other project settings.

Below are usage templates of index.qmd in different types of projects.

1.2 Basic `index.qmd` template for a website

---
title: "My Website with Quarto"
format: html
site:
  title: "Math Blog"
  navbar:
    left:
      - text: "Home"
        href: index.qmd
      - text: "Articles"
        href: articles.qmd
    right:
      - icon: github
        href: https://github.com/user
---

Body content:

# Welcome!

This is the official website of my personal blog with posts about mathematics, statistics, and data science.

1.3 `index.qmd` template for a Quarto book

---
title: "Introduction to Statistics"
author: "Blog do Marcellini"
format: html
book:
  chapters:
    - index.qmd
    - chapter-1.qmd
    - chapter-2.qmd
    - references.qmd
---

Body content:

# Introduction

This book was developed to help students understand the fundamental concepts of statistics with practical examples in R and Python.

1.4 `index.qmd` for a technical project or report

---
title: "Technical Analysis Report"
author: "Blog do Marcellini"
format: html
toc: true
number-sections: true
execute:
  echo: false
---

Content:

# Overview

This report presents the results of the exploratory analysis and statistical inference applied to dataset X.

1.5 Adding a cover image and description (for EPUB or book)

---
title: "Aesthetics and Mathematics"
author: "Blog do Marcellini"
date: 2025-06-23
format: epub
cover-image: cover-ebook.jpg
description: "A brief essay on beauty in pure mathematics."
toc: true
number-sections: true
lang: en
---

1.6 Conclusion

The index.qmd file serves as the entry point of a Quarto project — whether it’s a website, a book, a report, or an eBook.
These templates serve as starting points for structuring reusable and well-organized projects.

← Back to the Programming Reading Guide 👨‍💻

← Back to the Quarto Section 📄

← Back to the Programming Section 👨‍💻

🔝 Back to Top

Blog do Marcellini — Exploring Mathematics, Statistics, and Physics with Rigor and Beauty.