Skip to content

Style Options

Resumx exposes a set of style options you can override to customize your resume without touching your Markdown.

Overriding Styles

Set style: in frontmatter to override any option:

markdown
---
style:
  font-family: 'Inter, sans-serif'
  section-title-color: '#2563eb'
  section-title-border: none
---

You can also override via --style on the CLI. See the CLI Reference for details.

Priority: CLI --style > Frontmatter > Defaults

Options Reference

Typography

VariableDefaultDescription
font-family'Georgia', serifBase font stack (used by title and content when not set)
title-font-familyvar(--font-family)Font for name (h1) and section headings (h2)
content-font-familyvar(--font-family)Font for body text, entry titles (h3), bullets, etc.
font-size11ptBase font size (10–12pt recommended)
line-height1.4Line height ratio

Colors

VariableDefaultDescription
text-color#333Main text color
link-color#0563bbLink color
background-color#fffPage background

Headings

VariableDefaultDescription
name-size1.85remName (h1) font size
name-capssmall-capsName capitalization (small-caps, all-small-caps, normal)
name-weightnormalName font weight
name-italicnormalName italic (normal, italic)
name-colorvar(--text-color)Name (h1) color
section-title-size1.25remSection (h2) font size
section-title-capsnormalSection title capitalization
section-title-weightboldSection title font weight
section-title-italicnormalSection title italic (normal, italic)
section-title-colorvar(--text-color)Section title color
section-title-border1.5px solid var(--section-title-color)Section title underline border
header-aligncenterHeader alignment (left, center, right)
section-title-alignleftSection title alignment
entry-title-size1.05remEntry (h3) font size
entry-title-weightboldEntry title font weight
entry-title-italicnormalEntry title italic (normal, italic)
VariableDefaultDescription
link-underlinenoneLink underline style (underline, none)

Spacing

VariableDefaultDescription
page-margin-x0.5inHorizontal page margin
page-margin-y0.5inVertical page margin
gap1Unitless scale factor for all vertical gaps
section-gap10pxGap between sections (scaled by gap)
entry-gap5pxGap between entries (scaled by gap)
row-gap2pxVertical gap between list items, definition list rows, and table rows (scaled by gap)
col-gap12pxColumn gap for definition lists and tables
list-indent1.2emList indentation

Lists

VariableDefaultDescription
bullet-stylediscBullet point style (disc, circle, square, none)

Features

VariableDefaultDescription
auto-iconsinlineIcon display (inline, none)

Style Recipes

A few style: snippets that create distinct looks using only variable overrides.

Classic Serif (the default)

yaml
style:
  font-family: "'Georgia', serif"
  header-align: center
  name-caps: normal

No overrides needed, this is what you get out of the box.

Zurich

Warm serif with small-caps name and colored section headers.

yaml
style:
  font-family: "'Palatino Linotype', Palatino, Georgia, serif"
  name-caps: small-caps
  section-title-color: '#c43218'
  section-title-border: 1.5px solid var(--section-title-color)

Seattle

Clean sans-serif with left-aligned header and muted section borders.

yaml
style:
  font-family: "'Arial', 'Helvetica Neue', sans-serif"
  text-color: '#2d3748'
  section-title-border: 2px solid #b0b5be
  header-align: left
  bullet-style: circle

Minimal

No section borders, tight spacing, all-caps section titles.

yaml
style:
  section-title-border: none
  section-title-caps: uppercase
  section-gap: 6px
  entry-gap: 3px

Bold Modern

Strong contrast with a vibrant blue theme.

yaml
style:
  font-family: "'Inter', 'Segoe UI', sans-serif"
  name-weight: bold
  section-title-color: '#2563eb'
  link-color: '#2563eb'