Repository navigation
a11y: duplicate banner landmark from #quarto-header and #title-block-header #14375
Description
Reported in #14373 via axe-core scan of a minimal Quarto website.
Repro: https://github.com/alexpghayes/quarto-accessibility-reprex
axe rule: landmark-no-duplicate-banner · impact: moderate · tag: best-practice
Target: <header id="quarto-header" class="headroom fixed-top quarto-banner ...">
The Quarto HTML template renders two top-level <header> elements: <header id="quarto-header"> for the navbar and <header id="title-block-header"> for the title block. Each implicitly carries role="banner", producing two banner landmarks on the same page. axe-core flags this as ambiguous for assistive tech.
This also drives landmark-unique for #quarto-header — splitting into a separate issue because the fix paths differ (restructure title-block placement vs label the navigation).
Part of #8706.
Activity
cwickham commentedon Sep 1, 2026
The duplicate here comes from
title-block-banner: true, which the repro sets onindex.qmd. The title-block post-processor moves the header out of#quarto-content, which takes it out of<main>:quarto-cli/src/format/html/format-html-title.ts
Lines 261 to 268 in 7eebb00
The same branch runs for
title-block-style: manuscript.Since
#title-block-headeris a<header>, it computes as a banner whenever it is not inside<main>.#quarto-headeris always a banner, so the duplicate arises whenever the title block ends up outside<main>. #14605 and #14839 are the same problem through different code paths.