diff --git a/README.md b/README.md
index aace658..f4ecab7 100644
--- a/README.md
+++ b/README.md
@@ -1,41 +1,40 @@
-# The unreasonable effectiveness of HTML — examples
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/ThariqS/html-effectiveness) · [上游 README](https://github.com/ThariqS/html-effectiveness/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
 
-> **Sample code. Not maintained and not accepting contributions.**
+# HTML 的非同寻常效用 — 示例
 
-A gallery of standalone HTML examples that accompany the blog post on using HTML
-as a flexible output format. Each file is a self-contained `.html` page (no build
-step, no dependencies) demonstrating a different use case — from code review and
-design systems to slide decks, status reports, and small interactive editors.
+> **示例代码。未维护，且不接受贡献。**
 
-Open [`index.html`](index.html) for the full, categorized index, or open any
-numbered file directly in a browser.
+一组独立的 HTML 示例，配合关于将 HTML 用作灵活输出格式的博客文章。每个文件都是自包含的 `.html` 页面（无需构建步骤、无依赖），展示不同的用例 —— 从代码评审和设计系统，到幻灯片、状态报告和小型交互式编辑器。
 
-## Contents
+打开 [`index.html`](index.html) 查看完整分类索引，或直接在浏览器中打开任意编号文件。
 
-| Category | Examples |
+## 目录
+
+| 类别 | 示例 |
 |---|---|
-| Exploration | code approaches, visual designs |
-| Code | review, understanding, design systems, component variants |
-| Prototyping | animation, interaction |
-| Communication | slide deck, status report, incident report, PR write-up |
-| Diagrams & research | flowchart, feature/concept explainers |
-| Custom editing UIs | triage board, feature flags, prompt tuner |
+| 探索 | 代码方法、视觉设计 |
+| 代码 | 评审、理解、设计系统、组件变体 |
+| 原型设计 | 动画、交互 |
+| 沟通 | 幻灯片、状态报告、事故报告、PR 说明 |
+| 图表与研究 | 流程图、功能/概念说明 |
+| 自定义编辑界面 | 分诊看板、功能开关（feature flags）、提示词调优器 |
 
-## Running
+## 运行方式
 
-There is nothing to install or build. Clone the repo and open `index.html` (or
-any individual file) in a web browser.
+无需安装或构建。克隆仓库并在浏览器中打开 `index.html`（或任意单个文件）。
 
-## A note on sample data
+## 关于示例数据
 
-All product names, data, and scenarios in these examples are fictional and used
-only for illustration. The placeholder brand "Acme" and any figures shown are
-not real.
+这些示例中的所有产品名称、数据和场景均为虚构，仅用于演示。占位品牌「Acme」及所示的任何数据均非真实。
 
-## Security
+## 安全
 
-See [SECURITY.md](SECURITY.md) for how to report a vulnerability.
+有关如何报告漏洞，请参阅 [SECURITY.md](SECURITY.md)。
 
-## License
+## 许可证
 
-Released under the [Apache License 2.0](LICENSE).
+根据 [Apache License 2.0](LICENSE) 发布。