Understanding Quarto Listing Pages

Mr.Reporter

quarto

listing pages

How to use Quarto listings to create automated blog-style pages for your website.

Author

Mr.Brain

Published

April 17, 2026

What are Listing Pages?

Quarto listing pages allow you to automatically generate a list of content (like blog posts or articles) from a directory. This is essential for maintaining a structured technical blog.

Core Features

Automated Discovery: Quarto scans specified directories for .qmd or .md files.
Multiple Types: default, grid, or table.
Metadata Integration: Uses YAML headers for titles, dates, and descriptions.
Filtering & Sorting: Built-in support for categories and date-based sorting.

Configuration Example

In your index.qmd within the tech/ folder:

listing:
  contents: "."
  sort: "date desc"
  type: default
  categories: true

By following the “YYYY-MM-DD-topic” naming convention, we ensure both file-system order and chronological clarity for our technical stack documentation.