一、背景
通常作为技术人，写技术文章或者专栏我更喜欢使用 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 ，如果该工具的转换部分是收费的，大家就可以自己动手丰衣足食。
