Customizing Appearance
Themes
qrtdown uses Quarto’s built-in themes. Set the theme in _qrtdown.yml:
template:
theme: flatlyAvailable Themes
Popular options include:
cosmo(default) - Classic Bootstrap lookflatly- Flat design with subtle shadowslitera- Clean, minimal stylelumen- Light, readableminty- Fresh green accentssandstone- Warm, earthy tonessimplex- Simple and minimalyeti- 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: wrapOptions 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: wrapCustom 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.cssThen 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 |