Cooklang

Cooklang es un lenguaje de marcado de código abierto diseñado específicamente para recetas. En lugar de almacenar recetas en bases de datos complejas o formatos propietarios, Cooklang te permite escribirlas como archivos de texto plano con anotaciones simples — y tú eres dueño de cada archivo. Cualquier app que entienda la especificación Cooklang puede extraer ingredientes, utensilios y temporizadores directamente del texto, habilitando funciones como listas de compras automáticas, escalado de recetas y modo cocina sin entrada manual de datos.

Cómo funciona Cooklang

En Cooklang, escribes recetas como pasos naturales y marcas tres tipos de elementos:

La sintaxis es intencionalmente mínima. Puedes leer un archivo Cooklang sin ningún software especial — es solo un archivo de texto que también resulta ser legible por máquinas.

Sintaxis de ingredientes en detalle

Los ingredientes son el elemento que se anota con más frecuencia. Cooklang maneja varios casos comunes:

Esta simplicidad significa que pasas tu tiempo cocinando, no formateando datos.

Ejemplo de receta

Hervir @agua{1%litro} en una #olla grande.
Añadir @pasta{400%g} y cocinar durante ~{12%minutos}.
Escurrir y mezclar con @aceite de oliva{2%cda} y @ajo{2%dientes}, picado.
Sazonar con @sal{1%cdta} y @pimienta negra{1/2%cdta}.
Servir inmediatamente con @parmesano{30%g}, rallado.

A partir de este texto plano, un parser de Cooklang puede generar automáticamente:

• Una lista de ingredientes completa con cantidades
• Una lista de compras agrupada por categoría
• Instrucciones paso a paso para el modo cocina
• Cantidades escaladas para cualquier número de porciones

Cooklang vs otros formatos de recetas

La mayoría de los gestores de recetas almacenan tus datos en una base propietaria o usan formatos estructurados como JSON-LD, diseñados para motores de búsqueda en vez de para humanos. Cooklang toma un enfoque diferente: los archivos son legibles por humanos primero, por máquinas después. Puedes editar una receta Cooklang en cualquier editor de texto, guardarla en Git o moverla entre apps — sin problemas de importación ni dependencia de un proveedor.

Por qué Cooklang es útil para cocineros caseros

No necesitas saber programar para beneficiarte de Cooklang. El formato resuelve problemas reales que todo cocinero enfrenta:

Funciones avanzadas de Cooklang

Metadatos

Agrega información a nivel de receta al inicio de cualquier archivo Cooklang:

>> servings: 4
>> source: abuela
>> time: 45 minutos

Comentarios

Usa -- para comentarios en línea que el parser ignora:

Añadir @azúcar{200%g}. -- puedes reducir a 150g para menos dulzor

Recetas con múltiples pasos

Cada línea en un archivo Cooklang es un paso. Las líneas en blanco separan los pasos en grupos lógicos, haciendo que recetas complejas con docenas de pasos sean fáciles de seguir.

Escribir tu primera receta en Cooklang

1. Abre cualquier editor de texto (Bloc de notas, VS Code, TextEdit)
2. Escribe los pasos de tu receta como oraciones normales
3. Marca ingredientes con @nombre{cantidad%unidad}
4. Marca utensilios con #nombre
5. Marca temporizadores con ~{duración%unidad}
6. Guarda con extensión .cook
7. Abre en cualquier app compatible con Cooklang

La curva de aprendizaje es de unos cinco minutos. Si sabes escribir un mensaje de texto, sabes escribir en Cooklang.

Cooklang y las medidas

Cooklang funciona con cualquier sistema de unidades. Ya sea que prefieras gramos y mililitros o tazas y cucharadas, el formato se adapta. Apps como Fond que soportan conversión de unidades pueden incluso cambiar entre sistemas automáticamente, y usar una balanza de cocina con recetas Cooklang basadas en peso da los resultados más precisos al escalar.

Cooklang en Fond

Fond usa Cooklang por debajo, así que cada receta que guardas queda estructurada automáticamente — ingredientes, cantidades, temporizadores, todo. Funciones como el escalado de recetas, las listas de compras, la planificación de meal prep y el modo cocina funcionan directamente, sin etiquetado manual. También puedes importar recetas de otras fuentes y Fond las convierte a Cooklang automáticamente. No tienes que pensar en el formato.

Para saber más sobre la especificación, visita cooklang.org.

Preguntas frecuentes

¿Necesito saber programar para usar Cooklang?

No. Cooklang usa tres símbolos (@, #, ~) y texto plano. Si sabes escribir una receta en papel, sabes escribirla en Cooklang. La sintaxis se aprende en unos cinco minutos.

¿Puedo convertir mis recetas existentes a Cooklang?

Sí. Puedes agregar manualmente las anotaciones @, # y ~ a cualquier receta en texto, o usar apps como Fond que importan recetas y las convierten automáticamente.

¿Qué apps soportan Cooklang?

Varias apps y herramientas soportan Cooklang, incluyendo Fond, CookCLI (la herramienta oficial de línea de comandos) y parsers creados por la comunidad en múltiples lenguajes de programación. La especificación es abierta, así que cualquier desarrollador puede integrar soporte de Cooklang en su app.

¿Cooklang es bueno para recetas de panadería?

Sí. Las recetas de panadería se benefician especialmente de Cooklang porque las cantidades precisas son críticas. Cuando cada ingrediente tiene una cantidad y unidad parseada, el escalado de recetas y la conversión de unidades funcionan automáticamente. Los panaderos que usan porcentajes de panadero pueden incluso anotarlos en los metadatos.

¿Dónde debo guardar mis archivos Cooklang?

Donde sea que guardes archivos de texto — una carpeta en tu computadora, Dropbox, Google Drive o un repositorio Git. Como los archivos Cooklang son texto plano, son diminutos (unos pocos kilobytes cada uno) y funcionan con cualquier sistema de respaldo o sincronización.