cv Field

Header Information

The cv field begins with your personal information. All fields are optional. RenderCV adapts to whatever you provide.

cv:
  name: John Doe
  headline: Machine Learning Engineer
  location: San Francisco, CA
  email: [email protected] # (1)!
  phone: +14155551234 # (2)!
  website: https://johndoe.dev # (3)!
  photo: photo.jpg
  social_networks:
    - network: LinkedIn # (4)!
      username: johndoe
    - network: GitHub
      username: johndoe
  custom_connections:
    - placeholder: Book a call # (5)!
      url: https://cal.com/johndoe
      fontawesome_icon: calendar-days

1. Multiple emails can be provided as a list.
2. Multiple phone numbers can be provided as a list.
3. Multiple websites can be provided as a list.
4. Available social networks: << available_social_networks >>
5. Custom connections let you add any extra link (or plain text if url is omitted) with your own display text (placeholder) and a Font Awesome icon name (e.g., calendar-days, envelope). For the list of available icons, see fontawesome.com/search.

Sections

The sections field holds the main content of your CV. It's a dictionary where:

• Keys are section titles (displayed as headings). Section titles can be anything.
• Values are lists of entries

cv:
  name: John Doe

  sections:
    summary:
      - Software engineer with 10 years of experience in distributed systems.

    experience:
      - company: Acme Corp
        position: Senior Engineer
        start_date: 2020-01
        end_date: present
        highlights:
          - Led migration to microservices architecture
          - Reduced deployment time by 80%

    education:
      - institution: MIT
        area: Computer Science
        degree: BS
        start_date: 2012-09
        end_date: 2016-05

    skills:
      - label: Languages
        details: Python, Go, Rust, TypeScript
      - label: Infrastructure
        details: Kubernetes, Terraform, AWS

Section names are just titles. You can use any of the << entry_count >> entry types in any section. Choose what works best for your content.

For example, experience section could use NormalEntry:

sections:
  experience:
    - name: Acme Corp — Senior Engineer
      start_date: 2020-01
      end_date: present
      highlights:
        - Led migration to microservices architecture

Or BulletEntry for a minimal style:

sections:
  experience:
    - bullet: "**Acme Corp** — Senior Engineer (2020–present)"
    - bullet: "**StartupXYZ** — Founding Engineer (2018–2020)"

!!! warning "One entry type per section" Each section must contain only one type of entry. For example, you cannot mix ExperienceEntry and EducationEntry in the same section.

Entry Types

RenderCV provides << entry_count >> entry types: {$ for entry_name in entry_names $} << loop.index >>. << entry_name >> {$ endfor $} each rendered differently on the PDF.

{$ for entry_name, entry in sample_entries.items() $}

<< entry_name >>

{$ if entry_name == "EducationEntry" $} For academic credentials.

{$ elif entry_name == "ExperienceEntry" $} For work history and professional roles.

{$ elif entry_name == "PublicationEntry" $} For papers, articles, and other publications.

{$ elif entry_name == "NormalEntry" $} A flexible entry for projects, awards, certifications, or anything else.

{$ elif entry_name == "OneLineEntry" $} For compact key-value pairs, ideal for skills or technical proficiencies.

{$ elif entry_name == "BulletEntry" $} A single bullet point. Use for simple lists.

{$ elif entry_name == "NumberedEntry" $} An automatically numbered entry.

{$ elif entry_name == "ReversedNumberedEntry" $} A numbered entry that counts down (useful for publication lists where recent items come first).

{$ elif entry_name == "TextEntry" $} Plain text without structure. Just write a string.

{$ endif $}

<< entry["yaml"] >>

{$ for figure in entry["figures"] $} === "<< figure["theme"] >> theme" ![<< figure["alt_text"] >>](<< figure["path"] >>) {$ endfor $}

{$ endfor $}

Text Formatting & Features

Using Markdown

All text fields support basic Markdown:

highlights:
  - Increased revenue by **$2M** annually
  - Developed [open-source tool](https://github.com/example) with *500+ stars*

• **text** → bold
• *text* → italic
• [text](url) → hyperlink
• `code` → code

Using Typst

All text fields support

• Typst math (surround with $$ like $$f(x) = x^2$$)
• Typst commands (like #emph[emphasized]).

highlights:
  - Showed that $$f(x) = x^2$$ is a parabola
  - "This is an #emph[emphasized] text"

Arbitrary Keys

You can add arbitrary keys to any entry. By default, they're ignored, but you can reference them in design.templates field. See Arbitrary Keys in Entries for more information.

experience:
  - company: Startup Inc
    position: Founder
    start_date: 2020-01
    end_date: present
    revenue: $5M ARR  # Custom field
    highlights:
      - Built product from zero to profitability