One click generation and conversion of markdown directory to word format

One 、 background

Usually as a technician , I prefer to write technical articles or columns typora To write markdown Format , Because you don't need to pay much attention to format , Let me pay more attention to the content .

But if the article has many chapters , Hope to automatically generate directories . also , In some scenarios, you need to markdown The file to word perhaps pdf Format .

A simple way is to markdown Paste the bear In the notes , Click again to generate the directory , And then export to PDF, however bear Derived from PDF Is the charge , What about swelling ？

Here is a free conversion method .

Two 、 operation

2.1 install pandoc

According to your system , Select the corresponding installation package ： https://github.com/jgm/pandoc/releases

2.2 Carry out orders

2.2.1 Generate Directory

On the command line cd To the destination folder

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

–toc-depth=3 Indicates how many levels of directories to generate

If markdown The file name has some special characters , You need to put double quotes

Open the target markdown file , Discovery directory has been generated , Click to jump to the target location

2.2.2 Turn into Word

The order is as follows

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

Conversion success , One of the pictures cannot be parsed （ This can be handled manually later ）.

2.2.3 Turn into PDF

The order is as follows ：

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

2.2.4 turn epub Format

pandoc xxx.md -o xxxx.epub

Other instructions refer to https://pandoc.org/demos.html

3、 ... and 、 summary

quite a lot markdown The bottom layer of tool conversion format is used pandoc , If the conversion part of the tool is charged , Everyone can make plenty of food and clothing by themselves .