squidfunk/mkdocs-material 提供 MkDocs Material 主题完整构建环境，将 Markdown 文档编译为静态 HTML 站点。定位为 --rm 文档 CI 构建镜像，挂载 docs/ 与 mkdocs.yml 执行 mkdocs build；GitLab CI 或本地预览技术文档，输出目录挂载至 nginx 托管。

快速启动

docker run --rm \
  -v $(pwd):/docs \
  docker.io/squidfunk/mkdocs-material:latest \
  build

推荐实践

docker run --rm \
  -v /projects/docs:/docs \
  -v /projects/docs/site:/docs/site \
  docker.io/squidfunk/mkdocs-material:9.5.0 \
  build --strict

核心参数说明

• -v .../docs:... — 项目根目录含 mkdocs.yml
• build --strict — 警告视为错误
• 输出 — site/ 目录静态文件
• 托管 — nginx 或 S3 静态部署