diff --git a/03_install/3.1_ubuntu.md b/03_install/3.1_ubuntu.md
index 2336798..b7cc921 100644
--- a/03_install/3.1_ubuntu.md
+++ b/03_install/3.1_ubuntu.md
@@ -2,7 +2,7 @@
 
 Ubuntu 是 Docker 最常用的运行环境之一。本节将介绍如何在 Ubuntu 系统上安装 Docker，并配置国内镜像加速。
 
->警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
+> 警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
 
 ### 3.1.1 准备工作
 
@@ -76,7 +76,7 @@ $ echo \
 #   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```
 
->以上命令会添加稳定版本的 Docker APT 镜像源，如果需要测试版本的 Docker 请将 stable 改为 test。
+> 以上命令会添加稳定版本的 Docker APT 镜像源，如果需要测试版本的 Docker 请将 stable 改为 test。
 
 #### 安装 Docker
 
diff --git a/03_install/3.2_debian.md b/03_install/3.2_debian.md
index e92faa5..1e6f9d0 100644
--- a/03_install/3.2_debian.md
+++ b/03_install/3.2_debian.md
@@ -2,7 +2,7 @@
 
 Debian 以其稳定性著称，是 Docker 的理想宿主系统。本节将指导你在 Debian 上完成 Docker 的安装。
 
->警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
+> 警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
 
 ### 3.2.1 准备工作
 
@@ -67,7 +67,7 @@ $ echo \
 #   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```
 
->以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。Debian11 可能不使用 `/etc/apt/keyrings/`，如 gpg 错误可以考虑更换为 `/etc/apt/trusted.gpg.d`，见 [issue 15727](https://github.com/docker/docs/issues/15727)。
+> 以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。Debian11 可能不使用 `/etc/apt/keyrings/`，如 gpg 错误可以考虑更换为 `/etc/apt/trusted.gpg.d`，见 [issue 15727](https://github.com/docker/docs/issues/15727)。
 
 #### 安装 Docker
 
diff --git a/03_install/3.3_fedora.md b/03_install/3.3_fedora.md
index fb9d6d0..c26898e 100644
--- a/03_install/3.3_fedora.md
+++ b/03_install/3.3_fedora.md
@@ -2,7 +2,7 @@
 
 Fedora 作为技术前沿的 Linux 发行版，对 Docker 有着良好的支持。本节介绍在 Fedora 上的安装步骤。
 
->警告：切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker。
+> 警告：切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker。
 
 ### 3.3.1 准备工作
 
diff --git a/03_install/3.4_centos.md b/03_install/3.4_centos.md
index 2f00181..04a4471 100644
--- a/03_install/3.4_centos.md
+++ b/03_install/3.4_centos.md
@@ -2,7 +2,7 @@
 
 CentOS (及其替代品 Rocky Linux、AlmaLinux) 是企业级服务器常用的操作系统。本节介绍在这些系统上安装 Docker 的步骤。
 
->警告：切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker。
+> 警告：切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker。
 
 ### 3.4.1 准备工作
 
diff --git a/03_install/3.5_raspberry-pi.md b/03_install/3.5_raspberry-pi.md
index c507e99..9d08a71 100644
--- a/03_install/3.5_raspberry-pi.md
+++ b/03_install/3.5_raspberry-pi.md
@@ -2,7 +2,7 @@
 
 树莓派等 ARM 架构设备在物联网和边缘计算领域应用广泛。本节介绍如何在树莓派上安装 Docker。
 
->警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
+> 警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
 
 ### 3.5.1 系统要求
 
@@ -63,7 +63,7 @@ $ echo \
 #   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```
 
->以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。
+> 以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。
 
 #### 报错解决办法
 
diff --git a/06_repository/6.2_registry.md b/06_repository/6.2_registry.md
index 114409c..0f6f082 100644
--- a/06_repository/6.2_registry.md
+++ b/06_repository/6.2_registry.md
@@ -118,7 +118,7 @@ REPOSITORY                         TAG                 IMAGE ID            CREAT
 }
 ```
 
->注意：该文件必须符合 `json` 规范，否则 Docker 将不能启动。
+> 注意：该文件必须符合 `json` 规范，否则 Docker 将不能启动。
 
 ### 6.2.4 其他
 
diff --git a/06_repository/6.3_registry_auth.md b/06_repository/6.3_registry_auth.md
index 2504163..b671538 100644
--- a/06_repository/6.3_registry_auth.md
+++ b/06_repository/6.3_registry_auth.md
@@ -25,7 +25,7 @@ $ openssl req \
           -subj '/C=CN/ST=Shanxi/L=Datong/O=Your Company Name/CN=Your Company Name Docker Registry CA'
 ```
 
->以上命令中 `-subj` 参数里的 `/C` 表示国家，如 `CN`；`/ST` 表示省；`/L` 表示城市或者地区；`/O` 表示组织名；`/CN` 通用名称。
+> 以上命令中 `-subj` 参数里的 `/C` 表示国家，如 `CN`；`/ST` 表示省；`/L` 表示城市或者地区；`/O` 表示组织名；`/CN` 通用名称。
 
 第三步配置 `CA` 根证书，新建 `root-ca.cnf`。
 
diff --git a/07_dockerfile/7.2_copy.md b/07_dockerfile/7.2_copy.md
index 657d1a6..2af16ff 100644
--- a/07_dockerfile/7.2_copy.md
+++ b/07_dockerfile/7.2_copy.md
@@ -207,7 +207,7 @@ COPY --link --from=builder /app/dist /usr/share/nginx/html
 
 使用 `.dockerignore` 排除不需要复制的文件：
 
-```gitignore
+```text
 ## .dockerignore
 
 node_modules
diff --git a/10_buildx/10.2_buildx.md b/10_buildx/10.2_buildx.md
index 9b94d34..d6a42e3 100644
--- a/10_buildx/10.2_buildx.md
+++ b/10_buildx/10.2_buildx.md
@@ -40,12 +40,12 @@ $ docker buildx build --sbom=true -t myimage .
 
 > **⚠️ 注意与失败模式**：
 > 要使 SBOM (或其它 attestation 元数据) 成功附着并可见，对底层的存储格式有前置要求：默认的 classic image store 不支持 manifest list/index 这种存放 attestation 的结构。
-> 
-> 如果只简单运行上述命令，你可能会面临 **“命令成功执行，但本地镜像中看不到 SBOM”** 的体会落差。
-> 
+>
+> 如果只简单运行上述命令，你可能会面临 **”命令成功执行，但本地镜像中看不到 SBOM”** 的体会落差。
+>
 > **正确的解决路径有两条**：
-> 1. 在 Docker 守护进程中启用 `containerd image store` 特性（现代 Docker Desktop 默认推荐）。
-> 2. 或者使用 `docker-container` driver 的构建器，并直接 **加上 `--push` 参数** 将产物推送到远端支持 OCI 的镜像仓库，仓库会正确保存这些元数据。
+> 1. **推送到远端仓库**：使用 `docker buildx build --sbom=true --push -t myimage:tag` 时，SBOM 会正确保存到远端仓库。远端 OCI 兼容的镜像仓库能够完整存储这些元数据。
+> 2. **启用 containerd image store**：在 Docker 守护进程中启用 `containerd image store` 特性（Docker v29+，现代 Docker Desktop 默认推荐），可以在本地查看和管理 SBOM 等 attestation 元数据。
 
 ### 10.2.2 官方文档
 
diff --git a/11_compose/11.5_compose_file.md b/11_compose/11.5_compose_file.md
index 8859e39..d27b6ca 100644
--- a/11_compose/11.5_compose_file.md
+++ b/11_compose/11.5_compose_file.md
@@ -104,7 +104,7 @@ cgroup_parent: cgroups_1
 container_name: docker-web-container
 ```
 
->注意：指定容器名称后，该服务将无法进行扩展 (scale)，因为 Docker 不允许多个容器具有相同的名称。
+> 注意：指定容器名称后，该服务将无法进行扩展 (scale)，因为 Docker 不允许多个容器具有相同的名称。
 
 ### 11.5.7 `deploy`
 
@@ -138,7 +138,7 @@ services:
     image: postgres
 ```
 
->注意：`web` 服务不会等待 `redis` `db` “完全启动” 之后才启动。
+> 注意：`web` 服务不会等待 `redis` `db` “完全启动” 之后才启动。
 
 ### 11.5.10 `dns`
 
@@ -236,7 +236,7 @@ expose:
 
 ### 11.5.16 `external_links`
 
->注意：不建议使用该指令。
+> 注意：不建议使用该指令。
 
 链接到 Compose 文件外部的容器，甚至并非 `Compose` 管理的外部容器。
 
@@ -299,7 +299,7 @@ labels:
 
 ### 11.5.21 `links`
 
->注意：不推荐使用该指令。容器之间应通过 Docker 网络 (networks) 进行互联。
+> 注意：不推荐使用该指令。容器之间应通过 Docker 网络 (networks) 进行互联。
 
 ### 11.5.22 `logging`
 
diff --git a/11_compose/11.6_django.md b/11_compose/11.6_django.md
index 2bf15cd..54b45e0 100644
--- a/11_compose/11.6_django.md
+++ b/11_compose/11.6_django.md
@@ -267,7 +267,7 @@ web-1  | Watching for file changes with StatReloader
 web-1  | Starting development server at http://0.0.0.0:8000/
 ```
 
-打开浏览器访问 http://localhost:8000，可以看到 Django 欢迎页面！
+打开浏览器访问 `http://localhost:8000`，可以看到 Django 欢迎页面！
 
 ### 11.6.9 常用开发命令
 
diff --git a/12_implementation/12.3_cgroups.md b/12_implementation/12.3_cgroups.md
index 01ef585..716192d 100644
--- a/12_implementation/12.3_cgroups.md
+++ b/12_implementation/12.3_cgroups.md
@@ -200,6 +200,18 @@ $ docker run --rm --cpus=1 stress --cpu 4
 | PSI (压力监控)| ❌ | ✅ |
 | rootless 容器 | 部分支持 | 完整支持 |
 
+#### Docker 对 cgroups v2 的支持
+
+Docker 19.03+ 默认优先使用 cgroups v2（如果系统支持），提供更好的性能和资源隔离。如果需要明确控制或回退到 v1，可以通过 Docker 守护进程配置文件 `/etc/docker/daemon.json` 修改 `cgroup-driver` 参数：
+
+```json
+{
+  "cgroup-driver": "systemd"
+}
+```
+
+常见的 `cgroup-driver` 值包括 `systemd` (推荐) 和 `cgroupfs`。重启 Docker 守护进程后生效。
+
 #### 检查系统使用的版本
 
 ```bash
diff --git a/13_kubernetes_concepts/13.2_concepts.md b/13_kubernetes_concepts/13.2_concepts.md
index 75a9c2d..11ce542 100644
--- a/13_kubernetes_concepts/13.2_concepts.md
+++ b/13_kubernetes_concepts/13.2_concepts.md
@@ -44,9 +44,9 @@
 ```bash
 $ kubectl get nodes
 NAME           STATUS   ROLES           AGE   VERSION
-control-plane  Ready    control-plane   10d   v1.30.2
-worker-1       Ready    <none>          10d   v1.30.2
-worker-2       Ready    <none>          10d   v1.30.2
+control-plane  Ready    control-plane   10d   v1.35.1
+worker-1       Ready    <none>          10d   v1.35.1
+worker-2       Ready    <none>          10d   v1.35.1
 ```
 
 每个节点的详细信息以如下结构保存：
diff --git a/14_kubernetes_setup/14.2_kubeadm-docker.md b/14_kubernetes_setup/14.2_kubeadm-docker.md
index dd7d6b2..b5fcbc2 100644
--- a/14_kubernetes_setup/14.2_kubeadm-docker.md
+++ b/14_kubernetes_setup/14.2_kubeadm-docker.md
@@ -14,7 +14,61 @@
 
 参考[安装 Docker](../03_install/README.md) 一节安装 Docker。
 
-### 14.2.2 安装 **kubelet**、**kubeadm**、**kubectl**
+### 14.2.2 安装并配置 cri-dockerd
+
+由于 Kubernetes v1.24 移除了内置的 dockershim，需要额外安装 **cri-dockerd** 作为 Docker 与 kubelet 之间的 CRI（Container Runtime Interface）适配层。
+
+#### Ubuntu/Debian
+
+```bash
+## 安装 cri-dockerd
+
+$ cd /tmp
+$ wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.14/cri-dockerd-0.3.14.amd64.tgz
+$ tar xzvf cri-dockerd-0.3.14.amd64.tgz
+$ sudo mv cri-dockerd/cri-dockerd /usr/local/bin/
+
+## 下载并安装 systemd service 文件
+
+$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.service
+$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.socket
+$ sudo mv cri-docker.service cri-docker.socket /etc/systemd/system/
+
+## 启动 cri-dockerd
+
+$ sudo systemctl daemon-reload
+$ sudo systemctl enable cri-docker
+$ sudo systemctl start cri-docker
+
+## 验证安装
+
+$ sudo /usr/local/bin/cri-dockerd --version
+```
+
+#### CentOS/Fedora
+
+```bash
+## 安装 cri-dockerd
+
+$ cd /tmp
+$ wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.14/cri-dockerd-0.3.14.amd64.tgz
+$ tar xzvf cri-dockerd-0.3.14.amd64.tgz
+$ sudo mv cri-dockerd/cri-dockerd /usr/local/bin/
+
+## 下载并安装 systemd service 文件
+
+$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.service
+$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.socket
+$ sudo mv cri-docker.service cri-docker.socket /etc/systemd/system/
+
+## 启动 cri-dockerd
+
+$ sudo systemctl daemon-reload
+$ sudo systemctl enable cri-docker
+$ sudo systemctl start cri-docker
+```
+
+### 14.2.3 安装 **kubelet**、**kubeadm**、**kubectl**
 
 需要在每台机器上安装以下的软件包：
 
@@ -56,7 +110,7 @@ EOF
 $ sudo yum install -y kubelet kubeadm kubectl
 ```
 
-### 14.2.3 修改内核的运行参数
+### 14.2.4 修改内核的运行参数
 
 #### 加载内核模块
 
@@ -92,7 +146,7 @@ EOF
 $ sysctl --system
 ```
 
-### 14.2.4 配置 kubelet
+### 14.2.5 配置 kubelet
 
 为了让 kubelet 正确运行，我们需要对其进行一些必要的配置。
 
@@ -116,7 +170,7 @@ ExecStartPre=-/sbin/modprobe ip_vs_sh
 $ sudo systemctl daemon-reload
 ```
 
-### 14.2.5 部署
+### 14.2.6 部署
 
 安装配置完成后，我们将分别在 Master 节点和 Worker 节点上进行部署操作。
 
@@ -125,10 +179,12 @@ $ sudo systemctl daemon-reload
 ```bash
 $ sudo kubeadm init --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
       --pod-network-cidr 10.244.0.0/16 \
+      --cri-socket unix:///var/run/cri-dockerd.sock \
       --v 5 \
       --ignore-preflight-errors=all
 ```
 
+* `--cri-socket unix:///var/run/cri-dockerd.sock` 参数指定使用 cri-dockerd 作为容器运行时接口。
 * `--pod-network-cidr 10.244.0.0/16` 参数与后续 CNI 插件有关，这里以 `flannel` 为例，若后续部署其他类型的网络插件请更改此参数。
 
 > 执行可能出现错误，例如缺少依赖包，根据提示安装即可。
@@ -169,7 +225,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
     --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
 ```
 
-### 14.2.6 查看服务
+### 14.2.7 查看服务
 
 所有服务启动后，查看本地实际运行的 Docker 容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
 
@@ -189,7 +245,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
 
 * Etcd 是所有状态的存储数据库；
 
-### 14.2.7 使用
+### 14.2.8 使用
 
 将 `/etc/kubernetes/admin.conf` 复制到 `~/.kube/config`
 
@@ -197,7 +253,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
 
 由于未部署 CNI 插件，CoreDNS 未正常启动。如何使用 Kubernetes，请参考后续章节。
 
-### 14.2.8 部署 CNI
+### 14.2.9 部署 CNI
 
 这里以 `flannel` 为例进行介绍。
 
@@ -218,7 +274,7 @@ $ kubectl get node -o yaml | grep CIDR
 $ kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/v0.28.1/Documentation/kube-flannel.yml
 ```
 
-### 14.2.9 master 节点默认不能运行 pod
+### 14.2.10 master 节点默认不能运行 pod
 
 如果用 `kubeadm` 部署一个单节点集群，默认情况下无法使用，请执行以下命令解除限制
 
@@ -236,6 +292,6 @@ $ kubectl taint nodes --all node-role.kubernetes.io/master-
 ...
 ```
 
-### 14.2.10 参考文档
+### 14.2.11 参考文档
 
 * [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
diff --git a/15_etcd/15.2_install.md b/15_etcd/15.2_install.md
index 07be720..decd977 100644
--- a/15_etcd/15.2_install.md
+++ b/15_etcd/15.2_install.md
@@ -4,7 +4,7 @@
 
 `etcd` 基于 `Go` 语言实现，因此，用户可以从[项目主页](https://github.com/etcd-io/etcd)下载源代码自行编译，也可以下载编译好的二进制文件，甚至直接使用制作好的 `Docker` 镜像文件来体验。
 
->注意：本章节内容基于 etcd `3.4.x` 版本编写。etcd 3.4 的官方支持将于 **2026 年 5 月 15 日结束**，新部署建议使用 etcd `3.5` 或 `3.6` 版本。请访问 [etcd 官方发布页](https://github.com/etcd-io/etcd/releases) 获取最新版本。
+> 注意：本章节内容基于 etcd `3.4.x` 版本编写。etcd 3.4 的官方支持将于 **2026 年 5 月 15 日结束**，新部署建议使用 etcd `3.5` 或 `3.6` 版本。请访问 [etcd 官方发布页](https://github.com/etcd-io/etcd/releases) 获取最新版本。
 
 ### 15.2.1 二进制文件方式下载
 
diff --git a/15_etcd/15.4_etcdctl.md b/15_etcd/15.4_etcdctl.md
index 99a8329..129808c 100644
--- a/15_etcd/15.4_etcdctl.md
+++ b/15_etcd/15.4_etcdctl.md
@@ -87,7 +87,7 @@ OPTIONS:
 
 etcd 在键的组织上采用了层次化的空间结构 (类似于文件系统中目录的概念)，用户指定的键可以为单独的名字，如 `testkey`，此时实际上放在根目录 `/` 下面，也可以为指定目录结构，如 `cluster1/node2/testkey`，则将创建相应的目录结构。
 
->注：CRUD 即 Create，Read，Update，Delete，是符合 REST 风格的一套 API 操作。
+> 注：CRUD 即 Create，Read，Update，Delete，是符合 REST 风格的一套 API 操作。
 
 #### put
 
diff --git a/17_ecosystem/17.3_podman.md b/17_ecosystem/17.3_podman.md
index 74a15b1..8c5aa41 100644
--- a/17_ecosystem/17.3_podman.md
+++ b/17_ecosystem/17.3_podman.md
@@ -1,4 +1,4 @@
-## 17.3 podman - 下一代 Linux 容器工具
+## 17.3 Podman - 下一代 Linux 容器工具
 
 [Podman](https://github.com/containers/podman) 是一个无守护进程、与 Docker 命令高度兼容的下一代 Linux 容器工具。它由 Red Hat 开发，旨在提供一个更安全的容器运行环境。
 
diff --git a/19_observability/19.3_performance_optimization.md b/19_observability/19.3_performance_optimization.md
index 2c9c10f..51cf8c8 100644
--- a/19_observability/19.3_performance_optimization.md
+++ b/19_observability/19.3_performance_optimization.md
@@ -258,7 +258,7 @@ scrape_configs:
 
 **常用的 Prometheus 查询（PromQL）：**
 
-```promql
+```text
 # 容器 CPU 使用百分比
 rate(container_cpu_usage_seconds_total[5m]) * 100
 
diff --git a/21_case_devops/21.7_practical_examples.md b/21_case_devops/21.7_practical_examples.md
index 053901b..fbb98d3 100644
--- a/21_case_devops/21.7_practical_examples.md
+++ b/21_case_devops/21.7_practical_examples.md
@@ -529,7 +529,7 @@ HEALTHCHECK --interval=5s --timeout=3s --retries=5 \
 
 **redis.conf 配置：**
 
-```conf
+```text
 # 绑定地址
 bind 0.0.0.0
 
diff --git a/appendix/best_practices.md b/appendix/best_practices.md
index 4e49374..e28d256 100644
--- a/appendix/best_practices.md
+++ b/appendix/best_practices.md
@@ -70,7 +70,7 @@ RUN apt-get update && apt-get install -y \
 
 你可以给镜像添加标签来帮助组织镜像、记录许可信息、辅助自动化构建等。每个标签一行，由 `LABEL` 开头加上一个或多个标签对。下面的示例展示了各种不同的可能格式。`#` 开头的行是注释内容。
 
->注意：如果你的字符串中包含空格，必须将字符串放入引号中或者对空格使用转义。如果字符串内容本身就包含引号，必须对引号使用转义。
+> 注意：如果你的字符串中包含空格，必须将字符串放入引号中或者对空格使用转义。如果字符串内容本身就包含引号，必须对引号使用转义。
 
 ```docker
 ## Set one or more individual labels
@@ -290,7 +290,7 @@ fi
 exec "$@"
 ```
 
->注意：该脚本使用了 Bash 的内置命令 exec，所以最后运行的进程就是容器的 PID 为 1 的进程。这样，进程就可以接收到任何发送给容器的 Unix 信号了。
+> 注意：该脚本使用了 Bash 的内置命令 exec，所以最后运行的进程就是容器的 PID 为 1 的进程。这样，进程就可以接收到任何发送给容器的 Unix 信号了。
 
 该辅助脚本被拷贝到容器，并在容器启动时通过 `ENTRYPOINT` 执行：
 
@@ -328,7 +328,7 @@ $ docker run --rm -it postgres bash
 
 如果某个服务不需要特权执行，建议使用 `USER` 指令切换到非 root 用户。先在 `Dockerfile` 中使用类似 `RUN groupadd -r postgres && useradd -r -g postgres postgres` 的指令创建用户和用户组。
 
->注意：在镜像中，用户和用户组每次被分配的 UID/GID 都是不确定的，下次重新构建镜像时被分配到的 UID/GID 可能会不一样。如果要依赖确定的 UID/GID，你应该显式的指定一个 UID/GID。
+> 注意：在镜像中，用户和用户组每次被分配的 UID/GID 都是不确定的，下次重新构建镜像时被分配到的 UID/GID 可能会不一样。如果要依赖确定的 UID/GID，你应该显式的指定一个 UID/GID。
 
 你应该避免使用 `sudo`，因为它不可预期的 TTY 和信号转发行为可能造成的问题比它能解决的问题还多。如果你真的需要和 `sudo` 类似的功能 (例如，以 root 权限初始化某个守护进程，以非 root 权限执行它)，你可以使用 [gosu](https://github.com/tianon/gosu)。
 
diff --git a/book.json b/book.json
index 49e499f..74b6f87 100644
--- a/book.json
+++ b/book.json
@@ -9,17 +9,14 @@
   },
   "plugins": [
     "-livereload",
-    "image-captions",
+    "mermaid-gb3",
     "github",
     "page-treeview",
     "editlink"
   ],
   "pluginsConfig": {
-    "image-captions": {
-      "attributes": {
-        "width": "600"
-      },
-      "caption": "图 _PAGE_LEVEL_._PAGE_IMAGE_NUMBER_ - _CAPTION_"
+    "mermaid-gb3": {
+      "theme": "default"
     },
     "github": {
       "url": "https://github.com/yeasy/docker_practice"
@@ -48,4 +45,4 @@
       "bottom": 56
     }
   }
-}
\ No newline at end of file
+}
diff --git a/package.json b/package.json
index 76e16e1..ca3d3e7 100644
--- a/package.json
+++ b/package.json
@@ -7,6 +7,7 @@
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "esm": "^3.0.0",
+    "gitbook-plugin-mermaid-gb3": "^2.1.0",
     "honkit": "^6.1.6",
     "vuepress": "1.9.10",
     "vuepress-plugin-container": "^2.1.5",
@@ -30,4 +31,4 @@
     "url": "https://github.com/yeasy/docker_practice/issues"
   },
   "homepage": "https://github.com/yeasy/docker_practice#readme"
-}
\ No newline at end of file
+}