Customizing Appearance

Themes

qrtdown uses Quarto’s built-in themes. Set the theme in _qrtdown.yml:

template:
  theme: flatly

Available Themes

Popular options include:

  • cosmo (default) - Classic Bootstrap look
  • flatly - Flat design with subtle shadows
  • litera - Clean, minimal style
  • lumen - Light, readable
  • minty - Fresh green accents
  • sandstone - Warm, earthy tones
  • simplex - Simple and minimal
  • yeti - Friendly and approachable

See the complete list at Quarto HTML Themes.

Code Formatting

Control how long code lines are displayed:

template:
  theme: cosmo
  code_overflow: wrap

Options for code_overflow:

Value Behavior
wrap Long lines wrap to next line (default)
scroll Horizontal scrollbar for long lines
none No special handling

Complete Appearance Configuration

Here’s the full template section with all options:

template:
  # Quarto theme
  theme: cosmo

  # How to handle long code lines
  code_overflow: wrap

Custom CSS

For advanced customization beyond themes, you can add custom CSS. Create a styles.css file in your package root and reference it:

template:
  theme: cosmo
  css: styles.css

Then add your custom styles:

/* styles.css */
.navbar {
  background-color: #2c3e50;
}

code {
  color: #e74c3c;
}

Quick Reference

Setting Location Default
Theme template.theme cosmo
Code overflow template.code_overflow wrap
Custom CSS template.css none