HCL

slides は YAML を読むすべての場所で、 HCL2 のネイティブ構文も読み込みます。 HCL2 の式と関数を使うためです。

ディレクティブのコメント（<!-- class: invert -->）は Marp と同じく YAML のままで、 スライドデッキの本文も Go テンプレート のままです。

HCL で書くフロントマター

---hcl
theme    = "gaia"
paginate = true
title    = "Quarterly review"
data = {
  company = "ACME"
  quarter = 3
}
header = format("%s — Q%d", data.company, data.quarter)
footer = "${upper(data.company)} · ${page()}/${total()}"
date   = formatdate("D MMMM YYYY", now())

kind "chapter" {
  extends = "section"
  class   = ["lead", "invert"]
}
---

# {{ .title }}

• 属性 は、同じ名前の YAML のキーに対応します。Marp のディレクティブ （theme、paginate、header、footer、class、backgroundColor…）、 メタデータ（title、author…）、template、delims、kinds（ファイルの パス）、そしてオブジェクトである data です。
• kind "<name>" { … } ブロックは kind（スライドの種類）を定義します。 中にはローカルディレクティブと extends を書けます。
• 値 は、YAML の場合と同じ文字列の形でディレクティブに渡されます。 true は "true" になり、クラスのリストはリストのままです。そのため、どちらの構文で設定しても ディレクティブは同じように動作します。null を指定すると、そのディレクティブは未設定のままになります。
• data は型を保持します。テンプレート内では整数は int、 それ以外の数値は float64 になり、リストとオブジェクトはリストとマップのままです。そのため {{ add .quarter 1 }} が動作します。
• HCL の値は確定値です。Go テンプレートがその値に対してもう一度実行されることはありません。

変数

data はテンプレートのデータです。フロントマター自体の data に、 slides.hcl のもの、--data のファイル、--set の順に重ねられます。{{ .company }} が使える場所なら、 どこでも "${data.company}" が使えます。

フロントマターの属性は data.* を参照できますが、属性どうしは参照できません。 footer = title はエラーになります。スポットディレクティブ（_class…）は HCL の 識別子ではないので、コメントに書いてください。

関数

最初の 4 行以外は、go-cty の 標準ライブラリです。ネットワークにアクセスする関数はありません。

slides.hcl

kinds  = "kinds.hcl"          # or a list of files
themes = ["themes/acme.css"]
data   = { company = "ACME" } # or file paths
html   = false
lang   = "en"

kind "quote" {
  extends = "blank"
  footer  = "${data.company}"
}

未知の属性は、黙って無視されるのではなくエラーになります。kind のファイルには kind ブロックを書きます。それ以外の属性は無視されるので、slides.hcl を kind のファイルとしても 使えます。データファイルの属性は、そのままデータのキーになります。

# data.hcl
company = "ACME"
year    = 2026
motto   = trimspace(file("motto.txt"))

エラー

エラーは HCL の診断メッセージで、スライドデッキのファイル内の位置が示されます。 スライドデッキの 4 行目に footer = data.compnay と書くと、次のようになります。

deck.md:4:14: Unsupported attribute: This object does not have an attribute named "compnay".

Marp と slides expand

Marp も ---hcl をフロントマターの開始として読みます（Marp のフロントマターの ルールは、ダッシュ 3 つで始まる最初の行であれば何でも開始とみなすためです）。ただし、そのブロックは YAML のマッピングではないので、内容は何も適用されません。スライドデッキは Marp でもレンダリングされますが、 ディレクティブは反映されません。この挙動は、Marp Core 自身の出力と照らし合わせるテストで固定しています。

slides expand はフロントマターを YAML に書き戻すので、展開後のスライドデッキは プレーンな Marp になり、slides が元のスライドデッキをレンダリングしたときと同じようにレンダリングされます。

---
theme: "gaia"
paginate: true
title: "Quarterly review"
header: "ACME — Q3"
footer: "ACME · 1/2"
date: "19 October 2026"
---

ライセンス

HCL のサポートでは、hashicorp/hcl （MPL-2.0、ライブラリとして無改変で使用）と zclconf/go-cty（MIT）をリンクしています。