Cooklang

Cooklang est un langage de balisage open-source conçu spécifiquement pour les recettes. Au lieu de stocker les recettes dans des bases de données complexes ou des formats propriétaires, Cooklang vous permet de les écrire sous forme de fichiers texte brut avec des annotations simples — et vous restez propriétaire de chaque fichier. Toute application compatible avec la spécification Cooklang peut extraire les ingrédients, ustensiles et minuteurs directement du texte, permettant des fonctionnalités comme les listes de courses automatiques, la mise à l'échelle et le mode cuisine sans saisie manuelle.

Comment Cooklang fonctionne

En Cooklang, vous écrivez les recettes comme des étapes naturelles et annotez trois types d'éléments :

La syntaxe est volontairement minimale. Vous pouvez lire un fichier Cooklang sans logiciel spécialisé — c'est un simple fichier texte qui se trouve aussi être lisible par une machine.

Syntaxe des ingrédients en détail

Les ingrédients sont l'élément le plus fréquemment annoté. Cooklang gère plusieurs cas courants :

Cette simplicité signifie que vous passez votre temps à cuisiner, pas à formater des données.

Exemple de recette

Faire bouillir @eau{1%litre} dans une #grande casserole.
Ajouter @pâtes{400%g} et cuire pendant ~{12%minutes}.
Égoutter et mélanger avec @huile d'olive{2%cs} et @ail{2%gousses}, émincé.
Assaisonner avec @sel{1%cc} et @poivre noir{1/2%cc}.
Servir immédiatement avec @parmesan{30%g}, râpé.

À partir de ce texte brut, un parseur Cooklang peut automatiquement générer :

• Une liste d'ingrédients complète avec les quantités
• Une liste de courses classée par catégorie
• Des instructions pas à pas pour le mode cuisine
• Des quantités mises à l'échelle pour n'importe quel nombre de portions

Cooklang vs les autres formats de recettes

La plupart des gestionnaires de recettes stockent vos données dans une base propriétaire ou utilisent des formats structurés comme JSON-LD, conçus pour les moteurs de recherche plutôt que pour les humains. Cooklang adopte une approche différente : les fichiers sont lisibles par l'humain d'abord, par la machine ensuite. Vous pouvez modifier une recette Cooklang dans n'importe quel éditeur de texte, la stocker dans Git, ou la déplacer entre applications — sans galère d'importation ni dépendance à un éditeur.

Pourquoi Cooklang est utile pour les cuisiniers

Vous n'avez pas besoin d'être programmeur pour profiter de Cooklang. Le format résout des problèmes concrets que chaque cuisinier rencontre :

Fonctionnalités avancées de Cooklang

Métadonnées

Ajoutez des informations au niveau de la recette en haut de tout fichier Cooklang :

>> servings: 4
>> source: grand-mère
>> time: 45 minutes

Commentaires

Utilisez -- pour des commentaires en ligne que le parseur ignore :

Ajouter @sucre{200%g}. -- vous pouvez réduire à 150g pour moins de sucre

Recettes multi-étapes

Chaque ligne dans un fichier Cooklang est une étape. Les lignes vides séparent les étapes en groupes logiques, rendant les recettes complexes avec des dizaines d'étapes faciles à suivre.

Écrire votre première recette Cooklang

1. Ouvrez n'importe quel éditeur de texte (Bloc-notes, VS Code, TextEdit)
2. Écrivez vos étapes de recette comme des phrases normales
3. Marquez les ingrédients avec @nom{quantité%unité}
4. Marquez les ustensiles avec #nom
5. Marquez les minuteurs avec ~{durée%unité}
6. Enregistrez avec l'extension .cook
7. Ouvrez dans n'importe quelle application compatible Cooklang

La courbe d'apprentissage est d'environ cinq minutes. Si vous savez écrire un SMS, vous savez écrire en Cooklang.

Cooklang et les mesures

Cooklang fonctionne avec n'importe quel système d'unités. Que vous préfériez les grammes et millilitres ou les tasses et cuillères à soupe, le format s'en accommode. Des applications comme Fond qui supportent la conversion d'unités peuvent même basculer entre systèmes automatiquement, et utiliser une balance de cuisine avec des recettes Cooklang en poids donne les résultats les plus précis lors de la mise à l'échelle.

Cooklang dans Fond

Fond utilise Cooklang en coulisses, donc chaque recette que vous enregistrez est automatiquement structurée — ingrédients, quantités, minuteurs, tout. Les fonctionnalités comme la mise à l'échelle, les listes de courses, la planification de meal prep et le mode cuisine fonctionnent directement, sans balisage manuel. Vous pouvez aussi importer des recettes d'autres sources et Fond les convertit en Cooklang automatiquement. Vous n'avez jamais à y penser.

Pour en savoir plus sur la spécification, visitez cooklang.org.

Questions fréquentes

Faut-il savoir programmer pour utiliser Cooklang ?

Non. Cooklang utilise trois symboles (@, #, ~) et du texte brut. Si vous savez écrire une recette sur papier, vous savez l'écrire en Cooklang. La syntaxe s'apprend en cinq minutes environ.

Peut-on convertir des recettes existantes en Cooklang ?

Oui. Vous pouvez ajouter manuellement les annotations @, # et ~ à n'importe quelle recette texte, ou utiliser des applications comme Fond qui importent des recettes et les convertissent automatiquement.

Quelles applications supportent Cooklang ?

Plusieurs applications et outils supportent Cooklang, dont Fond, CookCLI (l'outil en ligne de commande officiel), et des parseurs communautaires dans plusieurs langages de programmation. La spécification est ouverte, donc tout développeur peut intégrer le support Cooklang dans son application.

Cooklang est-il adapté aux recettes de boulangerie ?

Oui. Les recettes de boulangerie bénéficient particulièrement de Cooklang car les quantités précises sont essentielles. Quand chaque ingrédient a une quantité et une unité parsées, la mise à l'échelle et la conversion d'unités fonctionnent automatiquement. Les boulangers qui utilisent les pourcentages de boulanger peuvent même les annoter dans les métadonnées.

Où stocker mes fichiers Cooklang ?

Partout où vous stockez des fichiers texte — un dossier sur votre ordinateur, Dropbox, Google Drive, ou un dépôt Git. Comme les fichiers Cooklang sont du texte brut, ils sont minuscules (quelques kilo-octets chacun) et fonctionnent avec tout système de sauvegarde ou synchronisation.