将Markdown转换为PDF文件(支持目录大纲)

• 1. Prince介绍
  • 1.1. 工具介绍
  • 1.2. 核心功能
• 2. Prince下载
• 3. Prince安装
• 4. MD生成PDF
  • 4.1. 前提条件
  • 4.2. 转换方法

在《VSCode系列1-VSCode搭建最强Markdown编辑环境》一文中提到我们可以在VSCode中通过Markdown PDF插件生成PDF文件，但这个方式生成的PDF不能支持目录大纲。

对于内容比较多的文章，目录大纲是非常有必要的，可以方便我们阅读和索引跳转。我们可以通过Prince工具来生成带目录的PDF文件。

1. Prince介绍

1.1. 工具介绍

Prince 是一个功能强大的工具，主要用于将 HTML 和 CSS 文档转换为 PDF，支持高质量的打印输出。它广泛应用于生成报表、电子书、发票、文档存档等场景。以下是 Prince 的主要特点和使用介绍：

1.2. 核心功能

1. 高质量的 PDF 输出

   • 支持精确的页面布局、分页控制、页眉页脚、目录生成等。
   • 保留 HTML/CSS 的样式，包括复杂的排版、字体、颜色和图形。

2. 完整的 CSS 支持

   • 支持 CSS Paged Media（分页媒体）和 CSS Print 标准，可以控制页面尺寸、边距、分页符等。
   • 支持 CSS 3 特性，如 Flexbox、Grid、Transformations 等。

3. JavaScript 处理

   • 可以执行 JavaScript 动态生成内容（如从 API 获取数据再转 PDF）。

4. 多平台支持

   • 提供 命令行工具、REST API 以及集成库（如 Python、Java、.NET 等）。

5. 支持多种输入

   • 可以直接转换 HTML 文件、URL，或通过 XML + XSLT 生成 PDF。

2. Prince下载

1. 进入官网地址： https://www.princexml.com/download/
2. 找到最新的版本(如Prince 16)。
3. 下载对于平台的安装包。

3. Prince安装

1. 双击打开安装包(如：prince-16-win64.msi)，根据提示一步一步安装即可。
2. 安装完后要设置环境变量，将安装目录下的engine\bin(如：C:\Program Files\Prince\engine\bin)添加到PATH环境变量中。
3. 打开命令行，输入prince -v命令，如果出现版本号，则安装成功。

1
2
3
4

prince --version
Prince 16
Copyright 2002-2025 YesLogic Pty. Ltd.
Non-commercial License

4. MD生成PDF

4.1. 前提条件

1. 安装号VSCode编辑器
2. 安装好VSCode的Markdown All in One插件

4.2. 转换方法

1. 打开MD文件的预览模式。
   • 方法一：在VSCode中打开MD文件，按Ctrl+Shift+V快捷键，切换到预览模式。
   • 方法二：在VSCode中打开MD文件，点击右下角的预览按钮，切换到预览模式。
2. 在预览页面鼠标右键，选择Export to PDF选项。
3. 在弹出的设置面板中，选择Prince作为，开始导出PDF文件。
4. PDF生成后，会自动使用默认PDF阅读器打开。