Reusable Report Template

My standard Quarto header, updated and ready to copy

Published

August 2, 2026

This template is based on the header used across my research notebooks and reports. It retains the author metadata, ORCID, institutional affiliation, table of contents, code tools, light and dark themes, and reproducible execution defaults.

The older version depended on a separate stylesheet and manually written social icons. This version uses native Quarto metadata instead, making it easier to move between projects.

Download the complete .qmd template

Header

---
title: "Document title"
subtitle: "Optional subtitle"
author:
  - name: Lucas Toshio Ito
    url: https://lucastoshioito.github.io/
    orcid: 0000-0001-9713-8687
    email: lucas.toshio.ito@gmail.com
    affiliations:
      - name: Universidade Federal de São Paulo (UNIFESP)
date: today
toc: true
toc-location: left
toc-title: Contents
number-sections: false
highlight-style: github
format:
  html:
    theme:
      light: flatly
      dark: darkly
    code-fold: true
    code-tools: true
    code-link: true
    df-print: kable
    embed-resources: true
execute:
  warning: false
  message: false
---

Setup cell

Place this immediately after the header:

#| label: setup
#| include: false

Sys.setlocale("LC_TIME", "C")
options(width = 700, height = 700)
knitr::opts_chunk$set(
  out.width = "100%",
  fig.showtext = TRUE,
  retina = 1
)

What to change

Replace the title and subtitle.
Add or remove affiliations as needed.
Change date: today to date: last-modified when appropriate.
Set code-fold: false when code should remain visible by default.
Remove embed-resources: true for large reports or website projects.
Add bibliography: references.bib when the report includes citations.

Suggested document skeleton

# Overview

State the objective and analysis question.

# Packages

Load every required package inside the document.

# Import data

Use paths relative to the project directory.

# Quality control

Document exclusions and transformations.

# Analysis

Keep each analytical step in a clearly labelled section.

# Results

Present tables and figures with captions and cross-references.

# Session information

Record package and R versions with `sessionInfo()`.