27.6K ·GitHub
这是什么？
Material for MkDocs 是一个基于 MkDocs 构建的文档主题和框架，可以把 Markdown 文件转换成专业、可搜索的静态文档网站。
Material for MkDocs 是一个基于 MkDocs 构建的文档主题和框架，可以把 Markdown 文件转换成专业、可搜索的静态文档网站。它是 MkDocs 上的主题，还是独立的静态站点生成器？它是扩展 MkDocs 的主题和框架，而不是它的替代品。你仍然用 Markdown 编写内容，由 MkDocs 生成网站，Material 只提供外观、交互效果和插件。
它是扩展 MkDocs 的主题和框架，而不是它的替代品。你仍然用 Markdown 编写内容，由 MkDocs 生成网站，Material 只提供外观、交互效果和插件。我该如何让它运行起来？用 pip 安装，然后在 mkdocs.yml 中添加几行配置，把它设为主题。
用 pip 安装，然后在 mkdocs.yml 中添加几行配置，把它设为主题。我需要先安装 Python 吗？需要。它是通过 pip 分发的 Python 包，因此必须有可用的 Python/pip 环境。
需要。它是通过 pip 分发的 Python 包，因此必须有可用的 Python/pip 环境。使用它需要懂 HTML、CSS 或 JavaScript 吗？不需要。这个项目的设计让你只需编写 Markdown 并配置 YAML，HTML、CSS 和 JS 的渲染由它自动完成。
不需要。这个项目的设计让你只需编写 Markdown 并配置 YAML，HTML、CSS 和 JS 的渲染由它自动完成。谁已经在生产环境中使用它？它受到大型公司和开源项目的信赖，包括 AWS、Google、Microsoft、Kubernetes、FastAPI 和 Pydantic。
它受到大型公司和开源项目的信赖，包括 AWS、Google、Microsoft、Kubernetes、FastAPI 和 Pydantic。我的文档网站在手机和平板上也能正常使用吗？可以，主题会自动将布局适配到桌面、平板和手机屏幕。
可以，主题会自动将布局适配到桌面、平板和手机屏幕。我的文档会托管在第三方平台上吗？不会。你完全拥有源文件和生成的输出文件，因此内容不依赖外部托管服务。
不会。你完全拥有源文件和生成的输出文件，因此内容不依赖外部托管服务。我可以自定义网站的外观吗？可以，通过几行配置就能更改颜色、字体、语言、图标和徽标，而且主题设计上易于扩展。
可以，通过几行配置就能更改颜色、字体、语言、图标和徽标，而且主题设计上易于扩展。文档支持多种语言吗？支持，网站内容和搜索功能支持 60 多种语言。
支持，网站内容和搜索功能支持 60 多种语言。内置搜索功能吗？内置。项目捆绑了基于客户端的搜索，使用 lunr 和 lunr-languages，因此无需服务器，文档开箱即可搜索。
内置。项目捆绑了基于客户端的搜索，使用 lunr 和 lunr-languages，因此无需服务器，文档开箱即可搜索。为什么要选它而不是普通的 MkDocs 主题？它针对速度和低资源占用做了优化，同时提供丰富的自定义选项（颜色、字体、图标），并且持续维护，已被 50,000 多名个人和组织使用，功能成熟，经过了实战检验。
它针对速度和低资源占用做了优化，同时提供丰富的自定义选项（颜色、字体、图标），并且持续维护，已被 50,000 多名个人和组织使用，功能成熟，经过了实战检验。What are similar projects?django-cms, zola, mkdocs, fumadocs, jekyll-theme-chirpy, quarkdown, docz, nextra
django-cms, zola, mkdocs, fumadocs, jekyll-theme-chirpy, quarkdown, docz, nextraWhich topics is it in?content-management, internationalization, documentation-tool, plugins, static-site-generator, material-design, pwa, theme, search, i18n, documentation, markdown
content-management, internationalization, documentation-tool, plugins, static-site-generator, material-design, pwa, theme, search, i18n, documentation, markdown