0%

利用Mkdocs批量导出MD为PDF

搭建Mkdocs知识库 的过程中,无意中发现了一些有意思的Mkdocs插件。其中插件mkdocs-pdf-export-plugin可以在mkdocs build的时候同时将MD文件转换为PDF。这里分享给需要的同学。

插件安装与使用

插件的Github仓库,zhaoterryy/mkdocs-pdf-export-plugin

1
pip install mkdocs-pdf-export-plugin

mkdocs.yml中添加插件

1
2
3
plugins:
- search
- pdf-export

mkdocs build成功后会提示共有多少个PDF转换成功。

1
Converting 13 files to PDF took 147.5s

生成的PDF文件与HTML文件在sites目录下的子文件夹之内。因此,如果只是单独想批量转换PDF,可以将所有MD文件放到docs根目录之下。

Quicker动作批量获取md文件路径

使用Mkdocs部署静态页面或导出PDF文件有个稍微麻烦的地方就是需要将md文件以及路劲填写到mkdocs.ymlnav:中。如果md文件太多时,可以使用Quicker动作批量获取md文件名及其路径。不会编程的我只能再用excel中ctrl+e功能批量将其组合改成符合mkdocs的键值组配格式再复制到yml文件中。

这里推荐2个Quicker动作:文件路径文件目录获取(脚本版)

当然,MD批量转换成PDF,还是推荐王树义老师的python工具:如何把 Markdown 文件批量转换为 PDF - 少数派