resume: Render a resume

In liteformats: Lightweight Output Formats for 'litedown'

Render a resume

Description

Render a Markdown or R Markdown resume to a self-contained HTML document or to PDF through a headless Chromium-based browser. The output format is inferred from the extension of output.

Usage

resume(
  input,
  output = NULL,
  author = NULL,
  job_title = NULL,
  address = NULL,
  phone = NULL,
  email = NULL,
  website = NULL,
  linkedin = NULL,
  font_family = NULL,
  google_font = NULL,
  font_files = NULL,
  font_size = NULL,
  font_scale = NULL,
  ligatures = NULL,
  line_height = NULL,
  paragraph_spacing = NULL,
  section_spacing = NULL,
  margins = NULL,
  paper = NULL,
  link_color = NULL,
  paged = NULL,
  keep_html = FALSE,
  browser = NULL,
  envir = parent.frame()
)

Arguments

input	Path to a .Rmd or .md source document.
output	Output path ending in .html or .pdf. If NULL, an HTML file is created beside input.
author, address, phone, email, website	Contact metadata. NULL uses the corresponding value in the source document's YAML header.
job_title, linkedin	Resume-specific professional and contact metadata.
font_family	A CSS font-family value. For example, "Charter, Georgia, serif".
google_font	A Google Fonts family name or a full Google Fonts CSS URL. This is an explicit online resource and is never used by default. A family name loads its default face; pass a full URL plus the matching font_family when specific axes or weights are required.
font_files	A named character vector or list of local font files. Names may be regular, italic, bold, and bold_italic. Relative paths are resolved from the source document. Fonts are embedded in the HTML.
font_size	A CSS length such as "11pt".
font_scale	A positive number used to scale font_size. This is useful when replacing a font with different metrics.
ligatures	Whether to enable common and discretionary ligatures. Defaults to FALSE for more predictable text extraction from PDFs.
line_height	A positive unitless CSS line height or CSS length.
paragraph_spacing, section_spacing	CSS lengths controlling vertical rhythm.
margins	Page margins. Supply one to four CSS lengths using standard CSS shorthand order, or numeric values interpreted as inches.
paper	A paper name ("letter", "a4", or "legal") or a two-element vector containing width and height as CSS lengths.
link_color	Any valid CSS color.
paged	Whether the HTML preview should open in a paginated layout. Printing always invokes the packaged pages.js pagination.
keep_html	For PDF output, whether to retain the intermediate HTML beside the PDF.
browser	Path to Chromium, Google Chrome, or Microsoft Edge. NULL lets xfun::browser_print() discover it.
envir	Environment in which R code in input is evaluated.

Details

Document metadata and typographic settings may be supplied in the YAML header. Renderer arguments take precedence over YAML. See use_resume() for a complete starter document.

Value

The normalized output path, invisibly.

Examples

source <- use_resume(tempfile(fileext = ".Rmd"))
resume(source, tempfile(fileext = ".html"))

## Not run: 
# PDF output requires a local Chromium-based browser
resume(source, "resume.pdf")

# Embed local font files
resume(
  source,
  font_files = c(
    regular = "fonts/MySerif-Regular.woff2",
    italic = "fonts/MySerif-Italic.woff2",
    bold = "fonts/MySerif-Bold.woff2"
  ),
  font_scale = 0.96,
  ligatures = FALSE
)

## End(Not run)

liteformats documentation built on Aug. 5, 2026, 9:08 a.m.