如何用 Chowdown 写菜谱：Markdown 格式与 Front Matter 新手完整指南

如何用 Chowdown 写菜谱Markdown 格式与 Front Matter 新手完整指南【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdownChowdown 是一个用 Markdown 格式写菜谱的开源项目它把每道菜保存为一个纯文本文件通过 Front Matter 记录原料、步骤、标签等信息再由 Jekyll 自动渲染成漂亮的网页。对新手来说这种写文本就是写菜谱的方式零门槛、易备份、好分享。本文是一份面向初学者的完整指南带你从认识目录结构开始一步步掌握 Markdown 菜谱的写作规范与 Front Matter 的全部核心字段。Chowdown 是什么为什么用 Markdown 写菜谱传统菜谱网站往往依赖复杂的后台编辑系统而 Chowdown 反其道而行菜谱就是文本文件。你不需要登录任何平台用记事本、VS Code 甚至手机备忘录就能写菜谱。纯文本的 Markdown 格式让菜谱天然支持版本管理Git、全文搜索和多语言展示多年后依然可读可维护。上图就是典型的 Chowdown 菜谱成品展示——每个菜谱文件对应一张主图图片文件名只需写进 Front Matter 的image字段即可自动匹配。菜谱文件放在哪里快速认识目录结构克隆仓库后你会看到几个关键目录_recipes/存放所有菜谱正文文件如 banana-bread.md_components/存放可复用的组件菜谱如 graham-cracker-crust.md_includes/存放页面片段其中 nutritional-information.html 负责渲染营养信息_layouts/页面模板recipe.html 是菜谱页的渲染模板_data/nutrients.yml营养素的名称与单位映射表写菜谱时绝大多数时间你只需要在_recipes/里新建一个.md文件。手写第一份菜谱认识 Front Matter 核心字段Front Matter 是 Markdown 文件最顶部用三条横线包裹的 YAML 区域它定义了菜谱的元数据。以项目自带的 banana-bread.md 为例--- layout: recipe title: Banana Bread image: banana-bread.jpg tags: - breakfast - baking ingredients: - 4 bananas - 1/2 cup butter - 1/2 cup sugar ingredients: - 2 eggs - 2 cups flour directions: - Beat the eggs, then cream with the butter and sugar - Mix in bananas, then flour, baking soda/powder, salt, and nuts - Bake until brown/cracked, toothpick comes out clean ---横线之下是菜谱的描述文字如From Angies mom会显示在标题下方。整份文件清晰、易读、无需任何格式技巧。一步步拆解Front Matter 每个字段怎么填字段作用必填layout固定写recipe告诉 Jekyll 使用菜谱模板是title菜谱名称会显示为页面大标题是image图片文件名对应images/目录下的图片推荐imagecredit图片来源致谢链接选填tags标签列表用于搜索和分类如 breakfast、desserts推荐ingredients原料清单逐条列出即可是directions烹饪步骤按顺序逐条写出是components组件式菜谱引用见下文进阶玩法选填nutrition营养信息配合_data/nutrients.yml使用选填每个字段都是一行键 值的简单格式列表项用-开头理解成本极低。进阶玩法用 components 组合出组件式菜谱Chowdown 最有特色的设计是组件式菜谱一个复杂菜谱可以拆成多个小菜谱分别维护再通过components字段组合。以 red-berry-tart.md 为例它并不直接写原料而是引用三个组件--- layout: recipe title: Red Berry Tart image: red-berry-tart.jpg components: - Graham Cracker Crust - Vanilla Custard Filling - Red Berry Dessert Topping ---三个组件分别存放在_components/目录下如 graham-cracker-crust.md、vanilla-custard-filling.md、red-berry-dessert-topping.md。组件本身也是完整的菜谱文件可以单独发布也可以被多个菜谱复用——写一次处处引用非常符合工程化思维。如果你的菜谱比如红莓挞天然由挞皮 馅料 装饰组成用组件式写法能让每部分都保持简洁也方便日后单独调整某一部分。让菜谱更专业营养信息与多语言展示Chowdown 还内置了营养信息与多语言能力。在 Front Matter 中加入nutrition字段页面就会自动渲染营养素卡片nutrition: servingSize: 1 slice calories: 350 fatContent: 12 proteinContent: 8营养素的中文名与单位由 _data/nutrients.yml 定义如calories对应 kcal、fatContent对应 g渲染逻辑在 nutritional-information.html 中你只需填写数值。多语言方面_config.yml中通过translation配置了英语、德语等多套界面文案改一行language即可切换整站语言菜谱正文则保持纯文本互不干扰。立即上手克隆仓库开始创作想立刻体验用 Markdown 写菜谱的乐趣只需克隆仓库git clone https://gitcode.com/gh_mirrors/ch/chowdown然后复制任意一个_recipes/下的文件改掉标题、原料和步骤放一张成品图到images/目录一份属于你的 Markdown 菜谱就诞生了 写在最后写菜谱也可以很简单Chowdown 用行动证明菜谱的本质是文本分享的本质是文件。掌握了 Front Matter 的这几个字段你就能高效地整理私人食谱库、与朋友协作维护甚至搭建一个属于自己的菜谱网站。现在就打开_recipes/目录写下你的第一道菜吧【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考