Title Blocks


HTML pages rendered with Quarto include a formatted title block at the start of the article. The title block contains the title, subtitle, authors, date, doi, and abstract.

A simple example title block looks like:

The title block will automatically layout elements from the front matter of the document. If you’d like, you can control the behavior using title-block-style.

There are three options available:


The default title-block treatment create a smaller font face and gathers the various title elements into stylized groups in the title block of the document.


The plain treatment will do all the title element processing (gathering and organizing the elements), but will not apply the default title block styling.


none disables title block processing altogether. Content will not be processed or organized and the title block will be emitted verbatim from Pandoc.

Title Banners

In addition, if you’d like a more prominent title block, you can use title-block-banner to create a banner style title block. A banner style title block will position the title, subtitle, description, and categories in a banner above the article. For example:

title-block-banner: true

will render a title block like:

Custom Backgrounds

In this case, the color of the banner is automatically determined based upon the theme. However, you can control the banner background by providing either a CSS color (e.g. "#FFDDFF", or red) or the path to an image which will be used the background. For example, to use a banner image, you might write:

title-block-banner: images/banner.jpeg

which would render a banner title block like:

When you provide an explicit background color or image, Quarto assumes that the color of the background will contrast with the body background color and automatically uses the body background color as the text color over the banner.

Foreground Color

You can specify the color the for the text of the banner as well, using title-block-banner-color and providing a CSS color (e.g. "#FFDDFF", or red) .


Quarto includes the document’s date in the title block. In addition to writing a standard date, you may also use a few special keywords which will generate a date for you. today will provide the current date with the current time, now will provide the current date and time, and last-modified will provide the file modification date and time of the document itself.


When your title block is output using the default or plain styles, Quarto will automatically format the date based upon the document locale (lang). You can control formatting by specifying a date-format in the document front matter. For example:

title: Summarizing Output for Reproducible Documents
date: 2018-05-04
date-format: short

For more about date formats, see the Quarto date format reference.