YAML Schema Reference

このページでは resume.yaml で利用可能なすべてのフィールドを説明します。ファイルは JSON Schema に基づいてバリデーションされます。

トップレベル構造

personalInfo:   # 必須 — 基本情報
sections:       # 順序付きセクション配列(配列順 = レンダリング順)

personalInfo — 基本情報

フィールド必須説明
namestringはい氏名
titlestringいいえ職種・肩書き
emailstringいいえメールアドレス
phonestringいいえ電話番号
locationstringいいえ所在地(例:「東京, 日本」)
linksarrayいいえリンクリスト(各項目に labelurl

Section Types — セクションタイプ

sections 配列の各セクションは type フィールドで構造とレンダリングが決まります。配列順でレンダリングされるため、順序を自由に変更してレイアウトをカスタマイズできます。

type: summary — 自己紹介

フィールド必須説明
type"summary"はい
titlestringいいえ見出しの上書き(デフォルト: "Summary")
taglinestringいいえ短いサブタイトル
contentstringはい自己紹介文(Markdown 対応)

type: experience — 職歴

items の項目:

フィールド必須説明
positionstringはい役職
organizationstringいいえ会社、コミュニティ、またはプロジェクト名
locationstringいいえ勤務地
startDatedateはい入社日
endDatedate | nullいいえ退社日(省略で在職中)
descriptionstringいいえ業務内容と実績(Markdown 対応)

type: education — 学歴

items の項目:

フィールド必須説明
institutionstringはい学校名
degreestringはい学位・専攻
locationstringいいえ所在地
startDatedateいいえ入学日
endDatedate | nullいいえ卒業日
descriptionstringいいえ関連科目、受賞歴など

type: skills — スキル

items の項目:

フィールド必須説明
categorystringはいカテゴリ名(例:「プログラミング言語」「フレームワーク」)
itemsstring[]はいスキルリスト

type: generic — 汎用構造化セクション

プロジェクト、資格、受賞歴などの構造化コンテンツに適しています。title 必須。

items の項目:

フィールド必須説明
titlestringはい項目タイトル
subtitlestringいいえサブタイトルまたは発行元
urlstringいいえリンク URL
startDatedateいいえ開始日
endDatedate | nullいいえ終了日
descriptionstringいいえ補足説明(Markdown 対応)

type: list — リスト

論文、語学力、コミュニティの役割などのシンプルなリストに適しています。title 必須。

フィールド必須説明
itemsstring[]はい項目リスト(各項目 Markdown 対応)

日付フォーマット

すべての日付フィールドは 3 つの形式を受け付けます:

  • YYYY — 年のみ(例:"2024"
  • YYYY-MM — 年月(例:"2024-03"
  • YYYY-MM-DD — 完全な日付(例:"2024-03-15"

重要:YAML では日付を必ず引用符で囲んでください。数値として解析されるのを防ぎます。

Markdown サポート

以下のフィールドは Markdown 構文をサポートしています:

  • summary.content
  • experience[].description
  • generic[].description
  • list[].items

サポートされる構文:**太字***斜体*`インラインコード`[リンク](URL)- リスト

YAML 記述のヒント

  • |(リテラルブロック)で複数行テキストを記述(改行を保持)
  • >-(フォールドブロック)で複数行を 1 行に結合(長い段落に最適)
  • コロン : や特殊文字を含む文字列は引用符で囲む
  • # でコメントを追加

完全な例

resume-template で完全な resume.yaml のサンプルファイルを確認できます。