Zensical 中文教程
-
为什么选择 Zensical？
- MkDocs for Material 已停止更新进入维护模式，Zensical 是官方推荐的新一代博客系统
- 即时导航，无需刷新页面
- 无需费心，开箱即用
- 性能优异，加载迅速
请在上方标签选择分类 / 左侧目录选择文章
请点击左上角图标选择分类和文章
不同于市面上过时的 MkDocs 教程（其实也是我写的），本站提供了 最详细、最便捷、最前沿 的 Zensical 中文教程，与 官方发布 的版本同步。包含了 Zensical 的安装、配置、主题美化、博客系统等内容。无论你是初学者还是有经验的用户，都能在这里找到你需要的帮助。𝓳𝓾𝓼𝓽 𝓮𝓷𝓳𝓸𝔂 𝓲𝓽～
当前状态 (2026年2月)
Zensical 处于 Alpha（PyPI），核心功能可用，部分能力开发中。详见 FAQ - 功能状态。
导航¶
-
快速开始
-
核心教程
-
插件系统(暂未开发)
-
部署指南
推荐学习路径¶
- 新手
5 分钟快速开始 → 配置详解 → 博客指南 → 主题定制 → GitHub Pages 部署 - 从 MkDocs 迁移
迁移指南 → 配置差异 → 测试后部署 - 进阶
性能、SEO、i18n、404/字体/评论 等见「高级主题」
快速开始¶
在项目目录下执行（需 Python 3.10+）：
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install zensical
zensical new .
zensical serve
浏览器打开 http://localhost:8000 即可预览。完整步骤见 5 分钟快速开始。
常用命令：zensical serve 预览，zensical build --clean 清理构建。
更多见 官方文档。Zensical 不支持 MkDocs hooks，可用模板覆盖或 JavaScript 替代。
案例¶
- Wcowin 的博客
- Suffine Hub
- Beyond欣's Notes
- 更多案例
- 基于 Mkdocs、Zensical 的主题与站点汇总在：GitHub Gist(支持评论提交)
贡献与联系¶
欢迎 Fork 后提 PR。
- GitHub：Wcowin/Zensical-Chinese-Tutorial
- Email：wcowin@qq.com
- 微信与 Telegram 见下方
微信
Telegram
