https://github.com/Yang-Xijie/mdbook-site
- 使用教程 mdbook-site
- 生成 mdBook
- 发布 GitHub Pages
个人更推荐 Material for MkDocs 一些,之前也用过 mdBook,但是...逐渐不能忍受 mdBook 的原因:
- 修改文章保存后在浏览器实时预览的功能有bug
- 不支持使用
$
符号来写数学公式 - 上面的导航栏特别大 而且突然出现 多次误点在正在看文章的时候跳转到页面顶部
- 不支持可交互的目录
- 随着文章增多 左侧的边栏变得越来越长 找文章很难找
Material for MkDocs 则真的很现代 开箱即用 可以配置的选项超级多
总之我是非常安利 使用指南 https://github.com/Yang-Xijie/mkdocs-site