`title-block-style: none` does not suppress title information when exporting to pdf

[samuelmehr]

I have:

• searched the issue tracker for similar issues
• installed the latest version of Quarto CLI
• formatted my issue following the Bug Reports guide

Bug description

I have a Quarto document that I need to export to both pdf and docx. I'd like to format the typst pdf with more advanced options than are available in YAML, as far as I know (e.g., placing the title in the center of the page, adjusting spacing etc); but I also would like the docx output to include the YAML metadata.

I thought I understood from the quarto typst docs that including title-block-style: none in the typst options in YAML should suppress the title page output in pdf, but it doesn't seem to do so.

Steps to reproduce

---
title: "MY AMAZING DOCUMENT"
author: "Johnny Cash"
date: today
format: 
  typst:
    title-block-style: none
  docx:
    toc: true
---

```{=typst}
// title page [not in yaml because I want this centered on its own page]

#set page(numbering: none) // no page number for title page

#align(center + horizon)[
  #text(24pt, weight: "bold")[MY AMAZING DOCUMENT]
  
  #v(4em)
  #text(16pt)[Johnny Cash]
  
  #v(0.5em)
  #text(12pt)[#datetime.today().display()]
]

Actual behavior

The code I included here exports the ordinary YAML-generated title/author info in addition to the manually-generated one.

Expected behavior

Title info should be suppressed.

Your environment

• IDE: Positron 2026.04.1 build 10
• OS: macOS 14.6

Quarto check output

Quarto 1.9.37
[✓] Checking environment information...
      Quarto cache location: /Users/sam/Library/Caches/quarto
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.8.3: OK
      Dart Sass version 1.87.0: OK
      Deno version 2.4.5: OK
      Typst version 0.14.2: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.9.37
      Path: /Applications/Positron.app/Contents/Resources/app/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: (external install)
      Chromium: (not installed)
      Chrome Headless Shell: (not installed)
      VeraPDF: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/sam/Library/TinyTeX/bin/universal-darwin
      Version: 2025

[✓] Checking Chrome Headless....................OK
      Using: Chrome found on system
      Path: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
      Source: MacOS known location

[✓] Checking basic markdown render....OK

[✓] Checking R installation...........OK
      Version: 4.4.1
      Path: /Library/Frameworks/R.framework/Resources
      LibPaths:
        - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library
      knitr: 1.48
      rmarkdown: 2.28

[✓] Checking Knitr engine render......OK

[✓] Checking Python 3 installation....OK
      Version: 3.9.6
      Path: /Library/Developer/CommandLineTools/usr/bin/python3
      Jupyter: (None)

      Jupyter is not available in this Python installation.
      Install with python3 -m pip install jupyter

[✓] Checking Julia installation...

[mcanouil]

Where did you see that title-block-style was a Typst option?
It's documented as an HTML option:

• https://quarto.org/docs/authoring/title-blocks.html

---

If you want to modify the layout of formats, see:

• https://quarto.org/docs/journals/templates.html

[samuelmehr]

Ah thanks, I didn't realize that section of the docs applied only to HTML (it might be good for docs to have clearer headings to state what formats each option applies to). Will play around with layout options in typst templates instead.

[mcanouil]

That's in the very first sentence:

HTML pages rendered with Quarto include a formatted title block at the start of the article

You also have the reference pages where this option only appears in the HTML one.

• https://quarto.org/docs/reference/
• https://quarto.org/docs/reference/formats/html.html

[samuelmehr]

Personally I would have expected a top-level header stating which format a set of docs applies to, if it doesn't apply to all formats, but maybe that's just me.

(Just tried Gemini's AI overview, which also gets this wrong, so perhaps not just me!)

[mcanouil]

Feel free to make a concrete proposal.

In my opinion, the first sentence scoped the whole page to HTML, adding "HTML" would not improve search and possibly hurt it.

(Just tried Gemini's AI overview, which also gets this wrong, so perhaps not just me!)

Claude gets it right:

In Quarto, which formats does `title-block-style` apply to?

The `title-block-style` option applies to **HTML** (`html`) format only.

It controls how the title block is rendered in HTML output, with options like `default`, `plain`, and `none`.