markdown 目录一键生成和转为 word 格式

一、背景

通常作为技术人，写技术文章或者专栏我更喜欢使用 typora 编写 markdown 格式，因为不需要太关注格式，让我能更关注内容。

但是如果文章章节较多时，希望可以自动生成目录。 还有，在某些场景下需要将 markdown 文件转为 word 或者 pdf 格式。

一个简单的做法就是将 markdown 粘贴到 bear 笔记里，再一键生成目录，然后导出到 PDF，但是 bear 中导出 PDF 是收费的，肿么办？

下面给出一个免费的转换方式。

二、操作

2.1 安装 pandoc

根据自己的系统，选择对应的安装包： https://github.com/jgm/pandoc/releases

2.2 执行命令

2.2.1 生成目录

在命令行中 cd 到目标文件夹

pandoc -s --toc --toc-depth=3 “xxxx.md” -o “xxxx2.md”

–toc-depth=3 表示要生成到几级目录

如果 markdown 文件名有一些特殊字符，需要加上双引号

打开目标 markdown 文件，发现目录已经生成，点击可以跳转到目标位置

2.2.2 转成 Word

命令如下

pandoc -f markdown -t docx “xxxx2.md” -o “xxxx2.docx”

转换成功，其中有张图片无法解析（这个后面手动处理即可）。

2.2.3 转成 PDF

命令如下：

pandoc xxx.md --pdf-engine=xelatex -o xxxx.pdf

2.2.4 转 epub 格式

pandoc xxx.md -o xxxx.epub

其他指令参考 https://pandoc.org/demos.html

三、总结

很多 markdown 工具转换格式底层就是用的 pandoc ，如果该工具的转换部分是收费的，大家就可以自己动手丰衣足食。