在搭建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 | plugins: |
mkdocs build
成功后会提示共有多少个PDF转换成功。
1 | Converting 13 files to PDF took 147.5s |
生成的PDF文件与HTML文件在sites目录下的子文件夹之内。因此,如果只是单独想批量转换PDF,可以将所有MD文件放到docs根目录之下。
Quicker动作批量获取md文件路径
使用Mkdocs部署静态页面或导出PDF文件有个稍微麻烦的地方就是需要将md文件以及路劲填写到mkdocs.yml
的nav:
中。如果md文件太多时,可以使用Quicker动作批量获取md文件名及其路径。不会编程的我只能再用excel中ctrl+e
功能批量将其组合改成符合mkdocs的键值组配格式再复制到yml
文件中。
这里推荐2个Quicker动作:文件路径和文件目录获取(脚本版)
当然,MD批量转换成PDF,还是推荐王树义老师的python工具:如何把 Markdown 文件批量转换为 PDF - 少数派