How Advanced Cooking Tips Are Structured in the HowToCook Repository

Advanced cooking tips in the HowToCook repository are structured as standalone Markdown files within the tips/advanced directory, utilizing a consistent schema of H1 headers, bullet lists, optional sub-headings, data tables, and blockquote notes.

The Anduin2017/HowToCook project organizes culinary knowledge through a hierarchical documentation system. Understanding how advanced cooking tips are structured enables contributors to maintain consistency and helps readers navigate complex techniques. These tips reside in a dedicated directory and follow a standardized Markdown format that supports tables, nested lists, and advisory blocks.

Directory Organization and File Format

Advanced cooking tips are stored in the tips/advanced directory of the repository. Each tip is a separate Markdown file with the .md extension, named descriptively in Chinese to reflect its content.

Key files in this directory include:

• 高级专业术语.md – Professional cooking terminology glossary
• 辅料技巧.md – Techniques for handling auxiliary ingredients
• 糖色的炒制.md – Guide for preparing caramelized sugar color
• 油温判断技巧.md – Methods for determining oil temperature

Structural Components of Advanced Cooking Tips

Each Markdown file follows a predictable pattern that ensures readability across static site generators and GitHub's native renderer.

Header Title

Every file begins with a level-1 heading (#) stating the tip's name. This serves as the document title and appears in navigation menus. For example, 辅料技巧.md starts with:

# 辅料技巧

Bullet Lists and Sections

The core content uses bullet lists to present concise guidelines, ordered steps, or key points. In 辅料技巧.md, the auxiliary ingredient order appears as a nested list explaining the sequence: starting with ginger, then garlic, and finally onions.

Sub-headings for Topic Separation

When a tip covers multiple distinct topics, level-2 headings (##) separate sections. The 辅料技巧.md file uses:

## 放盐时机与盐量控制

This isolates salt timing and quantity control from general auxiliary ingredient handling.

Data Tables

Complex techniques requiring matrix information utilize Markdown tables with alignment indicators. The 糖色的炒制.md file includes a detailed table mapping sugar states to preparation methods:

| 状态 | 制备方法 | 用途（例） |
|:--:|:--:|:--:|
| 未完全融化糖浆 | 水（油）炒8 | 挂霜山楂 |
| 完全融化糖浆 | 水（油）炒9 | 冰糖葫芦 |
| 焦糖 | 水（油）炒11后自然冷却 | 焦糖 |
| 糖色 | 水（油）炒13 | 糖色 |

Advisory Notes

Critical cautions appear as blockquotes using the > [!Note] syntax. For example:

> [!Note]
> 第13步补充：不建议使用冷水代替 70°C 热水…

This formatting renders as highlighted advisory blocks in compatible Markdown viewers.

References and Citations

Tips conclude with inline URLs linking to external standards, such as WHO guidelines on salt reduction. Each file also includes an invitation for readers to submit corrections via Issues or Pull Requests.

Practical Implementation Examples

Linking to Advanced Tips

To reference an advanced cooking tip from another document, use standard Markdown link syntax:

想了解烹饪时的油温判断技巧？请参阅  
[油温判断技巧](https://github.com/Anduin2017/HowToCook/blob/master/tips/advanced/油温判断技巧.md)  
获取完整步骤和注意事项。

Integrating with MkDocs

For documentation sites using MkDocs, add advanced tips to the navigation configuration in mkdocs.yml:

nav:
  - 首页: index.md
  - 基础技巧:
      - 食材准备: tips/厨房准备.md
  - 高级技巧:
      - 专业术语: tips/advanced/高级专业术语.md
      - 辅料技巧: tips/advanced/辅料技巧.md
      - 糖色的炒制: tips/advanced/糖色的炒制.md

Reusing Tabular Data

To incorporate a tip's table into another guide, copy the Markdown table syntax directly:

## 糖色状态对照表

| 状态 | 制备方法 | 用途（例） |
|:--:|:--:|:--:|
| 未完全融化糖浆 | 水（油）炒8 | 挂霜山楂 |
| 完全融化糖浆 | 水（油）炒9 | 冰糖葫芦 |
| 焦糖 | 水（油）炒11后自然冷却 | 焦糖 |
| 糖色 | 水（油）炒13 | 糖色 |

Summary

• Advanced cooking tips are stored as individual Markdown files in the tips/advanced directory of the Anduin2017/HowToCook repository.
• Each file follows a standardized structure: an H1 header, bullet lists for procedural steps, optional H2 sub-headings, Markdown tables for complex data, and blockquote notes for warnings.
• The plain-text format ensures compatibility with static site generators like MkDocs and native rendering on GitHub.
• Contributors can reference these tips using standard Markdown links or integrate them into documentation navigation systems.

Frequently Asked Questions

Where are advanced cooking tips stored in the HowToCook repository?

Advanced cooking tips are located in the tips/advanced directory. Each tip is a separate .md file named descriptively in Chinese, such as 高级专业术语.md for professional terminology or 糖色的炒制.md for caramelized sugar techniques.

What file format is used for advanced cooking tips?

The tips use Markdown (.md) format. This allows the content to render properly on GitHub and in static site generators while maintaining a plain-text structure that is easy to edit and version control.

How can I reference an advanced cooking tip in my own documentation?

Use standard Markdown link syntax pointing to the file path or GitHub URL. For example: [辅料技巧](https://github.com/Anduin2017/HowToCook/blob/master/tips/advanced/辅料技巧.md). You can also embed tables or copy content blocks directly into your guides.

Are there specific formatting requirements for tables in advanced tips?

Yes, tables follow standard Markdown pipe syntax with alignment indicators. The 糖色的炒制.md file demonstrates this with columns for state, preparation method, and usage examples. Tables typically include header rows and use |:--:| for centered alignment to ensure consistent rendering across platforms.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}