Markdown通过vscode生成PDF(带目录标签）

---

前言

vscode有插件可自动生成PDF，但生成的PDF都不待目录标签，长篇MD不好用，经过尝试摸索，终于实现生成的PDF带目录标签。

---

一、所需工具

• 【VS插件】Markdown All in One : 生成目录
• 【VS插件】Markdown Preview Enhanced : 预览及生成PDF
• 【VS插件】markdownlint : md语法及规范检查建议
• 【软件】prince 官网 : 真正生成PDF(带PDF目录标签)

二、配置

1.Markdown Preview Enhanced配置字体

如果不配置字体，生成的PDF字体很怪

打开vs，输入cmd-shift-p 打开命令面板，然后运行 Markdown Preview Enhanced: Customize Css，输入以下css代码

/* Please visit the URL below for more information: */
/*   https://shd101wyy.github.io/markdown-preview-enhanced/#/customize-css */
.markdown-preview.markdown-preview {
  font-family: Microsoft YaHei;
  /* prince配置 */
  &.prince {
    /* PDF底部加页码 */
    @page {
      @bottom {
        font-family: Microsoft YaHei;
        content: counter(page) " of " counter(pages)
      }
    }
  }
}

更多详细说明参考MDE完整中文手册

2.配置prince

1、prince尽量不要修改默认安装路径
2、安装完成后需要配置环境变量C:\Program Files (x86)\Prince\engine\bin

3.使用步骤

1、正常编写markdown，编写完成后必须保存，否则PDF无法更新
2、右键点击MPE:打开侧边预览。

3、在侧边预览处，右键点击PDF(prince)
4、PDF生成后，自动打开。

TIP:生成目录的方式有3种

• 手工输入[TOC]
• 通过Markdown Preview Enhanced插件生成
• 通过Markdown All in One插件生成（如图）
  

---