Référence du schéma YAML
Cette page décrit tous les champs disponibles dans resume.yaml. Le fichier est validé selon le JSON Schema.
Structure de premier niveau
personalInfo: # Requis — informations de base
sections: # Tableau ordonné de sections (l'ordre du tableau = l'ordre de rendu)personalInfo — Informations personnelles
| Champ | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Nom complet |
title | string | Non | Intitulé du poste |
email | string | Non | Adresse e-mail |
phone | string | Non | Numéro de téléphone |
location | string | Non | Localisation (ex. : « Paris, France ») |
links | array | Non | Liste de liens (chaque élément contient label et url) |
Types de section
Chaque section du tableau sections est définie par son champ type, qui détermine sa structure et son rendu. Les sections sont rendues dans l'ordre du tableau, vous pouvez donc les réorganiser librement.
type: summary — Résumé
| Champ | Type | Requis | Description |
|---|---|---|---|
type | "summary" | Oui | |
title | string | Non | Titre personnalisé (par défaut : « Summary ») |
tagline | string | Non | Sous-titre court |
content | string | Oui | Texte de présentation (Markdown supporté) |
type: experience — Expérience professionnelle
Chaque élément de items :
| Champ | Type | Requis | Description |
|---|---|---|---|
position | string | Oui | Intitulé du poste |
organization | string | Non | Entreprise, communauté ou projet |
location | string | Non | Lieu de travail |
startDate | date | Oui | Date de début |
endDate | date | null | Non | Date de fin (omis = en poste) |
description | string | Non | Missions et réalisations (Markdown supporté) |
type: education — Formation
Chaque élément de items :
| Champ | Type | Requis | Description |
|---|---|---|---|
institution | string | Oui | Nom de l'établissement |
degree | string | Oui | Diplôme et spécialité |
location | string | Non | Localisation |
startDate | date | Non | Date de début |
endDate | date | null | Non | Date de fin |
description | string | Non | Cours, distinctions, etc. |
type: skills — Compétences
Chaque élément de items :
| Champ | Type | Requis | Description |
|---|---|---|---|
category | string | Oui | Nom de la catégorie (ex. : « Langages », « Frameworks ») |
items | string[] | Oui | Liste des compétences |
type: generic — Section structurée générique
Idéal pour les projets, certifications, récompenses, etc. title requis.
Chaque élément de items :
| Champ | Type | Requis | Description |
|---|---|---|---|
title | string | Oui | Titre de l'élément |
subtitle | string | Non | Sous-titre ou émetteur |
url | string | Non | URL du lien |
startDate | date | Non | Date de début |
endDate | date | null | Non | Date de fin |
description | string | Non | Description complémentaire (Markdown supporté) |
type: list — Liste
Idéal pour les publications, langues, rôles communautaires, etc. title requis.
| Champ | Type | Requis | Description |
|---|---|---|---|
items | string[] | Oui | Liste d'éléments (Markdown supporté par élément) |
Format des dates
Tous les champs de date acceptent trois formats :
YYYY— année uniquement (ex. :"2024")YYYY-MM— année et mois (ex. :"2024-03")YYYY-MM-DD— date complète (ex. :"2024-03-15")
Important : encadrez toujours les dates entre guillemets en YAML pour éviter qu'elles soient interprétées comme des nombres.
Support Markdown
Les champs suivants supportent la syntaxe Markdown :
summary.contentexperience[].descriptiongeneric[].descriptionlist[].items
Syntaxes supportées : **gras**, *italique*, `code en ligne`, [lien](URL), - liste
Conseils YAML
|(bloc littéral) pour le texte multiligne (préserve les sauts de ligne)>-(bloc plié) pour fusionner plusieurs lignes en une seule (idéal pour les longs paragraphes)- Encadrez de guillemets les chaînes contenant
:ou des caractères spéciaux - Utilisez
#pour ajouter des commentaires
Exemple complet
Consultez le resume-template pour un fichier resume.yaml complet.