前言

游戏养胃了，啥也不想玩画也不想画，最近都在捣鼓自己的博客和一些静态网站工具

因为需要一个可以放置分享oc设定（并push自己认真写设定），甚至可以直接在上面写文的地方，所以物色了很多在线文档生成工具

但不幸的是一是我已经在vitepress上写不少了，搬别的地方还得重新配置，所以不搬了。。。

二是我开始认真的往vitepress上放一些自用的文档，再把oc设定和故事扔上面就显得不太合群了

然后就找到了这个mdbook，这个比起前面几个偏向于构建技术文档的工具，更像是一个电子书，对单纯的写作和发布更为友好，而且它还可以通过插件来直接导出为pdf，epub格式的文件

如果想把自己写的东西分享给别人看，mdbook还是比较不错滴。

安装

首先本来是要环境搭建的，这个工具是用rust语言写，但是安装rust环境太劝退了（至少对我来说）

好在mdbook提供了一个更简便，不用配rust环境的快速安装方式（不过要是打算进一步倒腾的话还是逃不过），去rust-lang/mdBook: Create book from markdown files. Like Gitbook but implemented in Rust的release下载mdbook-v0.5.2-x86_64-pc-windows-msvc.zip

下载解压过后里面只有一个mdbook，找个你想安装mdbook的目录把它放进去，然后在这里运行终端，输入如下指令：

1
mdbook init

就可以无痛安装了，会启动一个简单的安装向导，大概是让你给书起个标题之类的（可以后面改）

新建完毕后，文件夹内大概是这么个结构

1
2
3
4
5
book-test/
├── book
└── src
    ├── chapter_1.md
    └── SUMMARY.md

src是放置你的markdown文件和各种配置文件的地方，book是你的文件渲染后输出的位置，summary.md就是你的书的章节目录

现在可以直接运行

1
mdbook serve

来看看你的书以后会长什么样，还是比较极简的，同样可以一边修改文件，一边查看更新后的效果

写作和导出

后面实际上就没有什么可以说的了。。把自己的文章放进目录，然后编辑SUMMARY.md（注意它其实对目录的格式要求挺严格的，建议仔细阅读官方文档），效果差不多后，就可以构建为HTML，放到网站上给人看或者导出为PDF或EPUB就行了

总之在下面放了两篇参考文献，可以自己去探索，那么就写到这了（

参考