YAML Schema Reference
This page documents all fields available in resume.yaml. Your file is validated against our JSON Schema.
Top-Level Structure
personalInfo: # Required — your basic info
sections: # Ordered array of sections (render order = array order)personalInfo
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Full name |
title | string | No | Job title or headline |
email | string | No | Email address |
phone | string | No | Phone number |
location | string | No | City, Country |
links | array | No | List of { label, url } |
Section Types
Each section in the sections array has a type field that determines its structure and rendering. Sections are rendered in array order — reorder them to customize your layout.
type: summary
Field Type Required Description type"summary"Yes titlestring No Override heading (default: "Summary") taglinestring No Short headline contentstring Yes Professional summary (Markdown supported)
type: experience
Field Type Required Description type"experience"Yes titlestring No Override heading (default: "Experience") itemsarray Yes List of experience entries
Each item in items:
Field Type Required Description positionstring Yes Job title or role organizationstring No Company, community, or project name locationstring No City, Country startDatedate Yes Start date endDatedate | null No End date (omit for current) descriptionstring No Responsibilities and achievements (Markdown supported)
type: education
Field Type Required Description type"education"Yes titlestring No Override heading (default: "Education") itemsarray Yes List of education entries
Each item in items:
Field Type Required Description institutionstring Yes School or university name degreestring Yes Degree and major locationstring No City, Country startDatedate No Start date endDatedate | null No End date descriptionstring No Coursework, honors, etc.
type: skills
Field Type Required Description type"skills"Yes titlestring No Override heading (default: "Skills") itemsarray Yes List of skill groups
Each item in items:
Field Type Required Description categorystring Yes Category name (e.g. Languages, Frameworks) itemsstring[] Yes List of skills
type: generic
Use for structured sections like Projects, Certifications, Awards, etc.
Field Type Required Description type"generic"Yes titlestring Yes Section heading itemsarray Yes List of items
Each item in items:
Field Type Required Description titlestring Yes Item title subtitlestring No Subtitle or organization urlstring No Link URL startDatedate No Start date endDatedate | null No End date descriptionstring No Additional details (Markdown supported)
type: list
Use for simple bullet lists like Publications, Languages, Governance roles, etc.
Field Type Required Description type"list"Yes titlestring Yes Section heading itemsstring[] Yes List of items (each supports Markdown)
Date Format
All date fields accept three formats:
YYYY — year only (e.g. "2024")YYYY-MM — year and month (e.g. "2024-03")YYYY-MM-DD — full date (e.g. "2024-03-15")
Important: Always wrap dates in quotes in YAML to prevent them from being parsed as numbers.
Markdown Support
The following fields support Markdown:
summary.contentexperience[].descriptiongeneric[].descriptionlist[].items
Supported syntax: bold, italic, inline code, links, and bullet lists.
YAML Tips
- Use
| for multi-line strings (preserves line breaks) - Use
>- for folded strings (joins lines with spaces, strips trailing newline) - Wrap strings containing
: or special characters in quotes - Use
# for comments