【亲测免费】 VSCode Markdown PDF 插件使用教程

1. 项目介绍

vscode-markdown-pdf 是一个用于 Visual Studio Code 的扩展，它可以将 Markdown 文件转换为 PDF、HTML、PNG 或 JPEG 文件。这个插件支持多种 Markdown 语法扩展，如语法高亮、Emoji、Markdown-it 插件、PlantUML、Mermaid 等。通过这个插件，用户可以轻松地将 Markdown 文档转换为多种格式的文件，方便分享和打印。

2. 项目快速启动

安装插件

1. 打开 Visual Studio Code。
2. 进入扩展市场，搜索 Markdown PDF。
3. 点击安装。

使用插件

1. 打开一个 Markdown 文件。
2. 按 F1 或 Ctrl+Shift+P，输入 markdown-pdf: Export，选择你需要的导出格式（如 PDF、HTML、PNG、JPEG）。

// settings.json 配置示例
{
    "markdown-pdf.type": "pdf",
    "markdown-pdf.convertOnSave": true,
    "markdown-pdf.outputDirectory": "output",
    "markdown-pdf.styles": ["markdown-pdf.css"]
}

自动转换

在 settings.json 中添加以下配置，可以实现保存 Markdown 文件时自动转换为指定格式：

{
    "markdown-pdf.convertOnSave": true
}

3. 应用案例和最佳实践

案例1：文档转换

假设你有一个 Markdown 格式的项目文档，你可以使用 vscode-markdown-pdf 将其转换为 PDF 格式，方便打印和分享。

案例2：报告生成

在项目汇报时，你可以使用 Markdown 编写报告，然后通过插件将其转换为 PDF，确保格式一致且易于阅读。

最佳实践

• 自定义样式：通过 markdown-pdf.styles 配置自定义 CSS 文件，调整输出文件的样式。
• 自动转换：启用 markdown-pdf.convertOnSave 功能，每次保存 Markdown 文件时自动生成 PDF。

4. 典型生态项目

PlantUML

vscode-markdown-pdf 支持 PlantUML 语法，可以在 Markdown 文件中嵌入 UML 图，并将其转换为 PDF 或其他格式。

Mermaid

Mermaid 是一个用于绘制流程图、时序图、甘特图等的工具，vscode-markdown-pdf 支持 Mermaid 语法，可以直接在 Markdown 中绘制图表。

Markdown-it 插件

vscode-markdown-pdf 支持多种 Markdown-it 插件，如 markdown-it-include、markdown-it-container 等，可以扩展 Markdown 的功能。

通过这些生态项目，vscode-markdown-pdf 可以实现更丰富的文档格式和内容展示。