Configuration
Marque configuration is split across two places:
marque.toml
Site-wide defaults live here. This is where you set your title, description, default layout, theme, and page width once for the whole site.
Page frontmatter
Individual .mq pages can override the defaults they care about without changing the rest of the site.
If a page does not define an override, it inherits the value from marque.toml.
Minimal site config
title = "Marque"
description = "Built with Marque"
layout = "sidebar"
theme = "comte"
width = "full"That is enough to define the site's baseline behavior.
What each setting controls
Identity
title and description define the site's default branding and metadata.
title: used in page titles and nav brandingdescription: fallback meta description for generated pages
Presentation
layout and theme decide how the site looks and where global navigation appears.
layout:sidebarortopnavtheme: the active CSS theme file
Content width
width controls the usable width of .mq-main. It can be a number, a percentage, or named presets like narrow, normal, wide, and full.
Choose the right place
Use marque.toml when you want a default that should apply everywhere.
Use frontmatter when a page needs a one-off layout, width, theme, or slug.
Use summary.mq when you want to change labels, ordering, and navigation structure.
Files that work together
marque.toml
Defines defaults for the whole site.
Frontmatter
Overrides defaults for one page at a time.
summary.mq
Controls navigation labels, ordering, grouping, and nesting.
Continue with the focused pages
Frontmatter
See the exact page-level keys, examples, and width override behavior.
Open frontmatter docs ->
Layouts
Compare sidebar and topnav, and see how summary-driven navigation changes between them.
Open layout docs ->
Themes
Learn how theme files work, how to override a page theme, and which built-in themes ship with Marque.
Open theme docs ->