コンテンツフロントマター

コンテンツフロントマターとは？

コンテンツフロントマターは、コンテンツファイルの冒頭に配置される構造化メタデータセクションで、通常はYAML形式で、公開日・著者・カテゴリ・タグなどの重要情報を記述するものです。 静的サイトジェネレータ（HugoやJekyll）やModern CMSがコンテンツを自動整理・表示する際に、このメタデータを読み込みます。

ひとことで言うと： 本の目次や奥付みたいに、文章本体の前に「この記事は何か」という情報をまとめて書くイメージです。

ポイントまとめ：

• 何をするものか： コンテンツの属性情報（日付・著者・分類など）を機械可読な形式で埋め込む仕組み
• なぜ必要か： ウェブサイトエンジンが自動的にコンテンツを分類・整理・表示できるようにするため
• 誰が使うか： 技術ブログ、ドキュメントサイト、静的サイトジェネレータを使う組織

仕組みをわかりやすく解説

フロントマターは2つの区切り文字（通常は---）に挟まれたYAML形式のデータです。

YAML形式の利点は、人間が読み書きしやすく、同時にプログラムが確実に解析できる点です。例えば、title: ブログ記事と書けば、テンプレートエンジンが自動的にそのタイトルをページの見出しや検索結果に表示できます。

主要なフロントマター項目は、タイトル、公開日、更新日、説明文（検索結果に表示）、著者、カテゴリ、タグなどで、サイトに応じてカスタム項目も追加できます。

処理フローとしては、ジェネレータがファイルを読み込む → フロントマターを解析 → テンプレートに渡す → HTMLを生成、という流れで進みます。フロントマターのデータがなければ、サイトは各ページをどう扱ってよいか判断できません。

実際の活用シーン

ブログ管理 — 投稿のタイトル、公開日、著者、カテゴリをフロントマターで指定すれば、ブログプラットフォームが自動的に「2026年4月投稿」や「マーケティングカテゴリ」別ページを生成します。

技術ドキュメント — APIドキュメントではバージョン、関連ページ、難易度レベルをフロントマターに記述し、サイト全体での一貫した構成を実現します。

多言語サイト — 同じコンテンツの言語バージョンをリンクするため、フロントマターに言語コードと対応ページのURLを記述します。

メリットと注意点

メリット面では、コンテンツと構造化情報を一つのファイルで管理でき、バージョン管理システムで変更を追跡しやすく、自動化処理が簡単になります。

注意点としては、YAML形式の複雑さ（インデント、特殊文字のエスケープなど）で、非技術者の参入障壁が生じることです。また、スキーマ変更時に既存ファイル全体の修正が必要になる場合があります。

関連用語

• 静的サイトジェネレータ — フロントマターを処理するテクノロジー
• メタデータ — フロントマターが担う情報の総称
• コンテンツ管理 — フロントマターで実装されるメタデータ管理
• テンプレート — フロントマター情報を利用してレンダリングする仕組み
• SEO最適化 — フロントマターのメタディスクリプションが検索結果に表示される

よくある質問

Q: YAML以外の形式でも良い？ A: 多くのツールはYAMLをサポートしていますが、JSONやTOML形式も選択可能です。プロジェクトの標準に従いましょう。

Q: 誰がフロントマターを書く？ A: コンテンツ作成者が書くのが一般的です。テンプレートやプリセットを用意することで、記入のハードルを下げられます。

Q: 間違ったフロントマターでどうなる？ A: 多くのジェネレータはエラーを報告するか、デフォルト値を使用します。ビルド時に検証機構があれば、問題を早期に発見できます。