Front matter

ファイル先頭の YAML ブロックです。ドキュメントのメタデータや、component の props 契約として使います。

---
title: My Page
author: Alice
---

# {{ title }}

Written by {{ author }}.

役割

1. ドキュメントのメタデータ — レンダリング開始時にテンプレート変数へ注入される初期値
2. component の props 契約 — 型・必須・デフォルトを定義（include と component）

出力時の扱い

デフォルトでは、レンダリング後の Markdown から front matter は 除去されます。残したい場合は preserveFrontMatter: true を指定します。

サイズ制限

front matter のソースは 最大 64 KB です。超過すると frontmatter_too_large エラーで中断します。

props 契約（component 用）

component ファイルでは、front matter で props を定義します。

---
props:
  name:
    type: string
    isRequired: true
    default: "Ethan Hunt"
  age:
    type: number
---

type を省略すると、渡された値や default から推論します。

実行時の挙動

変数の優先順位

固定の優先順位はありません。適用・呼び出し順に束縛し、あとから同名が来たら上書きします。

1. API の context が先に入る
2. ファイルの front matter が後から適用されれば上書き
3. component 呼び出しの props がさらに後なら、component 内ではそれが勝つ

注意

• 秘密情報を front matter に書かないこと（運用上の推奨）
• front matter は YAML のみ対応

関連

• include と component
• 式と変数展開