HCL

Allí donde slides lee YAML, también lee la sintaxis nativa de HCL2, por sus expresiones y sus funciones.

Los comentarios de directivas (<!-- class: invert -->) siguen siendo YAML, como en Marp, y el cuerpo de la presentación sigue siendo una plantilla de Go.

Un front matter en 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 }}

• Los atributos son las claves de YAML con los mismos nombres: las directivas de Marp (theme, paginate, header, footer, class, backgroundColor…), los metadatos (title, author…), template, delims, kinds (rutas de archivos) y data, un objeto.
• Los bloques kind "<name>" { … } definen kinds (tipos de diapositiva), con las directivas locales y extends.
• Los valores llegan a las directivas en las formas de cadena que les da YAML (true es "true", una lista de clases es una lista), de modo que una directiva se comporta igual sea cual sea la sintaxis que la fije. null deja una directiva sin definir.
• data conserva sus tipos: en las plantillas un número entero es un int, los demás números son float64, y las listas y los objetos siguen siendo listas y mapas, de modo que {{ add .quarter 1 }} funciona.
• Un valor HCL es definitivo: las plantillas de Go no se ejecutan sobre él por segunda vez.

Variables

data son los datos de la plantilla: el propio data del front matter, superpuesto al de slides.hcl, a los archivos de --data y a --set. "${data.company}" funciona allí donde funcionaría {{ .company }}.

Los atributos del front matter pueden hacer referencia a data.*, pero no entre sí: footer = title es un error. Las directivas locales de una sola diapositiva (_class…) no son identificadores de HCL; escríbalas en un comentario.

Funciones

Todas salvo las cuatro primeras filas son la biblioteca estándar de go-cty. Ninguna accede a la red.

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}"
}

Un atributo desconocido es un error, no una operación nula silenciosa. Un archivo de kinds contiene bloques kind; sus demás atributos se ignoran, así que slides.hcl puede servir como uno. Los atributos de un archivo de datos son las claves de los datos:

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

Errores

Los errores son los diagnósticos de HCL, situados en el propio archivo de la presentación: footer = data.compnay en la cuarta línea de la presentación da

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

Marp y slides expand

Marp también lee ---hcl como el inicio de un front matter (su regla de front matter se abre con cualquier primera línea que empiece por tres guiones) y, al no ser el bloque un mapa YAML, no aplica nada de él: la presentación se sigue renderizando en Marp, pero sin sus directivas. Una prueba lo fija contra la propia salida de Marp Core.

slides expand vuelve a escribir el front matter como YAML, de modo que la presentación expandida es Marp plano y se renderiza como slides renderiza la original:

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

Licencias

La compatibilidad con HCL enlaza hashicorp/hcl (MPL-2.0, usado sin modificar como biblioteca) y zclconf/go-cty (MIT).