Theming

In v1, a theme is primarily a CSS file.

Default behavior

If no custom theme is provided, mkpages writes the bundled default stylesheet to assets/site.css.

Bundled themes

mkpages currently ships with:

• default
• dark
• minimal

Select one with:

mkpages build docs/ --theme dark
mkpages build docs/ --theme minimal

Override with theme.css

If the content root contains theme.css, that file wins automatically.

Example tree:

docs/
  index.md
  theme.css

Then:

mkpages docs/ --output .mkpages

uses docs/theme.css.

Override with --theme

If there is no theme.css at the content root, you can pass either a bundled theme name or a CSS file path explicitly:

mkpages build docs/ --theme ./themes/my-site.css

See CLI Reference for the full option summary.