Cook Lab 做飯指南：用 Docusaurus 把烹飪知識做成 Markdown 文件站

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

Cook Lab（做飯指南）是一份把烹飪知識用 Markdown 寫成、再用 Docusaurus 架成靜態文件站的免費知識庫。它不是食譜 App，沒有排餐、採購清單、營養計算這類互動功能，價值在於「文件式導航」和一份可以拿來自架的批量上線流程。如果你平常查食譜是用 App、把廚房筆記記在 Notion，這份知識庫能不能幫上你，要看你比較需要一份整理好的參考資料，還是一套會幫你算分量、排這週菜單的工具。

Cook Lab 的真實身份：Docusaurus 文件站，不是開源專案

Cook Lab 的網址是 docs.cook.ninthfeast.com，從首頁原始碼可以看出它是用 Docusaurus 這套開源文件框架架出來的，頁尾版權寫著「© 2025 做飯指南」，頁尾的 GitHub 連結則是指向 Docusaurus 官方，而不是 Cook Lab 自己的程式庫。這個細節要先講清楚：Cook Lab 是一個用開源框架蓋起來的網站，不是一個對外開源、可以 clone 整份程式碼的專案。能免費看、能照它的批量上線流程自己重做一份，但拿不到它的原始 Markdown 內容。

這個定位決定了它與一般食譜網站的差別。它的內容結構長得像軟體文件：左邊有側邊欄分類，每篇文章有標準 frontmatter，網站本身靜態、載入快、沒有登入或會員系統。對喜歡這種「翻說明書」式導航的人很順手，但若你期待的是像 CookHero 那種會根據庫存與偏好推菜單的自架型 recipe agent，Cook Lab 完全不碰這一層，它只把寫好的文章擺出來給你讀。

「靜態文件站」對讀者實際意味著幾件事。先說個人化：網站不提供帳號、收藏清單或做菜紀錄，你看到的內容和所有人都一樣。搜尋功能靠 Docusaurus 內建的全文索引，速度比一般資料庫網站快，但只能精確比對關鍵字，不會理解「冰箱剩下半顆高麗菜能做什麼」這種語意查詢。內容更新方面，每次都要營運者重新跑一次匯入腳本並重新部署，更新頻率取決於營運者投入的時間，讀者無法即時看到社群貢獻。

6 個模組、32 篇文章的內容範圍

首頁把整份知識庫分成六個模組，每個模組都對應一組 Markdown 文件：

Pin

• 打底（基礎知識）：廚房裝備、常備清單、30 天養成計畫，給零基礎的人快速學會在家下廚。
• 技法（烹飪技法）：刀工、火候、調味的核心原理。
• 食材（食材處理）：肉禽海鮮、蔬菜豆類的處理 SOP。
• 菜譜（菜系菜譜）：家常菜、地方菜與國際料理的配方，首頁宣稱有 100 道家常菜大全。
• 健康（營養與安全）：營養搭配、食品安全、特殊飲食需求。
• 專題（專題製作）：麵食、烘焙、醃製等垂直攻略。

首頁的數字寫「32 篇精選內容／6 模塊覆蓋全流程／15 分鐘找到一份新指南」，這些是作者自己列的統計，實際篇數與品質會隨更新變動，要把數字當作宣稱規模而非保證。模組分類本身倒是清楚，從基礎到進階、從備料到營養都各佔一塊，跟一般食譜網站「中式、西式、早餐、點心」這種以菜色類型為主的分類邏輯完全不同。

最具體的一篇是「廚房新手 30 天養成計畫」。這份計畫把 30 天拆成四週：第一週學煮飯、煮麵、蒸蛋和三道簡單炒菜，第二週進入炒肉與葷素搭配，第三週練燉煮，第四週做湯與涼拌，目標是 30 天後掌握 20 道以上家常菜。計畫裡連採購清單都列好了，基礎工具編列約人民幣 200 元（炒鍋、湯鍋、菜刀、砧板、鍋鏟湯勺、碗盤筷子、保鮮盒），基礎食材約人民幣 150 元（米、麵、油、醬油醋料酒蠔油、蔥薑蒜、蛋）。每天投入時間寫 40 到 60 分鐘。

計畫的細項寫得相當白話。以第一天為例，題目是煮一鍋米飯，步驟從量米、洗米、加水（水位是米面上一個指節高，或米水比 1 比 1.2）、按下電飯煲、跳鍵後燜十分鐘，到鬆飯出鍋，連「新米少加水、陳米多加水」「加幾滴油讓米飯更香」這類經驗技巧都列出來。第三天教蒸蛋，會講到蛋與水 1 比 1.5 的比例、為什麼要用溫水而不是冷水或開水、過篩去泡沫的目的。這些是純文字教學，沒有影片，也沒有計時器或份量計算機，讀者要自己拿鍋鏟跟著做。

這些數字與步驟都是計畫頁面上的規格，能不能照著 30 天做完、做出來的菜是不是真的能吃，需要自己跟著幾天才會知道，計畫本身不提供任何成果保證。但就文件本身的完整度來說，它比一般食譜網站「精選十道新手菜」那種清單多了循序漸進的結構，缺點是沒有任何互動輔助。

批量上線 SOP 是給誰用的

Cook Lab 有一頁叫「批量上線 SOP」，這頁才是它對工程師最有參考價值的地方。它示範的是一套把任何一個 Markdown 資料夾自動轉成 Docusaurus 文件站的流程，核心是一支 TypeScript 腳本 scripts/import-docs.ts：

Pin

pnpm install
pnpm import-docs -- --source ../../your-markdown-folder
pnpm start      # 本地預覽
pnpm build      # 生成靜態站

腳本支援三個參數：--source 指定 Markdown 來源資料夾、--target 指定輸出目錄、--slugBase 可選幫 slug 加前綴。幾個關鍵行為要注意：腳本預設會清空目標 docs 目錄後再寫入、自動補上 id／title／sidebar_label／slug 四個 frontmatter 欄位、README 裡的目錄連結要指向具體檔案不要連到純資料夾、想保留手寫的特殊頁面要先備份再跑。Cook Lab 自己預設的來源路徑指向一個叫「做飯指南」的資料夾（官方頁面用簡體字書寫），從命名風格也能看出 Cook Lab 與 ninthfeast.com 作品集裡其他 lhqs 系列網站是同一個營運者維護。

換句話說，這頁 SOP 對「想查食譜」的讀者沒用，它是寫給「想拿這個架構自己架一份知識庫」的人看的。如果你只是要查晚餐做什麼，這整段對你沒用；但如果你想做的就是 Cook Lab 對工程師特別有參考價值的那一塊，這份流程幾乎可以照抄。

與食譜 App 的差異與硬限制

Cook Lab 的硬限制要講明白，否則很容易被「知識庫」「管理系統」這類詞誤導：

• 沒有互動功能。沒有排餐、採購清單、營養計算、收藏、個人化推薦，也不會記錄你做過哪道菜。整份網站是靜態文件，所有「互動」都靠你自己讀、自己記。
• 拿不到原始 Markdown。GitHub 連結指向 Docusaurus 框架，Cook Lab 本身沒有公開 repo，你只能讀網頁版，無法下載 32 篇 Markdown 自己改。
• 內容品質未經外部驗證。營養、食品安全、特殊飲食這幾個模組屬於醫療與健康相對敏感的領域，Cook Lab 是工程師副業專案，不是營養師或食安專家審稿的平台。32 篇的品質是否一致、食譜是否經過實做驗證，從公開頁面看不出來。把它當查靈感與基本流程的參考起點比較穩，遇到健康相關的具體建議，例如減脂、控糖、過敏原，請再對照專業來源。
• 營運者背景。第九宴（Ninth Feast）是一名中國獨立開發者，作品集首頁自述列了 50 個以上專案，包含創作者平台、書籤管理、AI 中繼、組件庫等。Cook Lab 是其中一項，不是專職食譜團隊的作品。這影響你對它更新頻率與長期維護的預期。

和食譜 App 比，Cook Lab 缺的是「會幫你算」的那一層；和把食譜記在 Markdown 筆記 或 Notion 裡比，Cook Lab 多的是「一份已經分好類、有導航的現成內容」。如果你重視的是免費、無廣告干擾、文件式導航體驗，Cook Lab 合用；如果你要的是「幫我決定今晚煮什麼、幫我列出要買什麼」的智能推薦，目前它做不到，建議另外找自架型 recipe agent 或商業食譜 App。

Cook Lab 適合哪些讀者，又有哪些人會白跑一趟

把前面的限制綜合起來，Cook Lab 的定位其實很窄，可以先判斷自己是不是它的讀者再決定要不要花時間翻。

適合的讀者大致有兩種。第一種是剛開始學做飯、想要一份循序漸進參考資料的人，30 天養成計畫那條路線把工具、食材、每天要做什麼都列好了，比單篇食譜容易跟。第二種是想用 Docusaurus 自架一份知識庫、需要一份現成範本參考發布流程的開發者，Cook Lab 的批量上線 SOP 等於把「Markdown 資料夾變成有側邊欄的文件站」這件事做過一次給你看。

不適合的讀者也有兩種。第一種是需要互動功能的人，例如想讓工具根據冰箱庫存推薦菜單、自動產生採購清單、計算每餐營養素，或記錄自己做過哪些菜。Cook Lab 是靜態文件站，這些功能一律沒有，硬要用只會失望。第二種是需要專業把關的讀者，特別是涉及減脂、控糖、過敏原、特殊疾病飲食這類健康決策。Cook Lab 的健康模組是工程師整理的知識庫，不是營養師或食安專家審稿的內容，當參考起點可以，當專業建議來用風險太高。

另一個要接受的現實是長期維護的不確定性。Cook Lab 是第九宴的其中一個專案，不是商業服務，沒有付費會員撐著營運成本，也沒有公開的更新計畫。它能用多久、會不會持續更新，取決於作者個人意願。如果你打算把 Cook Lab 當成長期依賴的知識來源，這點要先想清楚；如果只是拿來入門或借鏡它的發布流程，這個風險可以接受。

怎麼開始用

直接打開 docs.cook.ninthfeast.com 就能看，不用註冊、不用付費。入門路徑有兩條：

第一條是給烹飪新手。從首頁點進「廚房新手 30 天養成計畫」，照第一週到第四週的順序走。計畫本身是文章，沒有進度追蹤，所以要不要真的每天做、要不要照單採購，得自己安排。計畫裡的採購清單是以人民幣價格列的，台灣的使用者要自己換算實際成本與通路。

第二條是給想自架一份知識庫的開發者。照批量上線 SOP 那頁的指令，把 Docusaurus 裝起來、準備好你自己的 Markdown 資料夾、跑 pnpm import-docs 帶 --source，就會得到一個結構跟 Cook Lab 一樣的靜態站。這條路對已經在用 自架筆記工具、或想自己整理一套知識庫的人比較對盤，因為它把「怎麼把一堆 Markdown 變成有側邊欄、有分類、有搜尋的網站」這件事縮成三行指令。

要強調一次：Cook Lab 不是開源專案，SOP 頁教的是「流程」不是「Cook Lab 的程式碼」。能學的是它發布文件的方法，不是直接 fork 它的文章內容。如果你要的是免費查一份還算完整的中文烹飪入門知識庫，它算乾淨好讀；如果你要的是會替你動手算、動手排的工具，這份知識庫離那個目標還有距離。

一個簡單的判斷方式：如果你的需求是「我想看一份整理過的烹飪知識，自己決定怎麼用」，Cook Lab 值得放進書籤，搭配像 FoodCompass 食物評分 這類評分工具輔助選菜；如果你要的是「我想丟出庫存與偏好，讓工具回我今晚做什麼」，把時間省下來，直接找具備推薦與排餐能力的食譜 App 或自架 recipe agent 會更實際。