一、背景

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

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

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

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

二、操作

2.1 安装 pandoc

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

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

其他指令参考 <a href="https://pandoc.org/demos.html">https://pandoc.org/demos.html</a>

三、总结

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

原文地址：https://blog.csdn.net/w605283073/article/details/122907633?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522168905674116800227431657%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fall.%2522%257D&request_id=168905674116800227431657&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_ecpm_v1~rank_v31_ecpm-5-122907633-null-null.142^v88^control_2,239^v2^insert_chatgpt&utm_term=markdown