# Markdown转PDF教程：代码高亮+公式+图表，一键导出排版精美的PDF

> 来源：工具派（https://gjupai.com） 原文页面：https://gjupai.com/tutorial/markdown-to-pdf-guide


![图片](/api/file/download?path=article/202607/1783912229569_6406.png)

![图片](/api/file/download?path=article/202607/1783912242503_6064.png)

![图片](/api/file/download?path=article/202607/1783912254020_4124.png)
## 工具简介

Markdown 转 PDF 是一款专为写作者准备的排版导出工具：左边写 Markdown 源码，右边实时渲染预览，确认排版后一键导出 PDF。它不只会转换标题和列表，还支持代码语法高亮、KaTeX 数学公式、Mermaid 流程图/时序图，以及表格、引用等完整语法，导出的 PDF 排版精美、可直接打印或归档。

页面还提供明亮/暗黑主题、A4/Letter 尺寸、纵向/横向、边距和字号调节，技术文档、学习笔记、周报方案都能轻松转成正式 PDF。

![Markdown转PDF工具界面](/api/file/download?path=article/202607/1783912229569_6406.png)

## 第一步：准备 Markdown 内容

有两种方式准备内容：

- **直接编辑**：左侧源码区自带一份示例文档，展示了代码块、公式、Mermaid 图表和表格的写法，可以直接在上面修改；
- **上传文件**：点「选择文件」上传本地的 .md、.markdown 或 .txt 文件，上传后会替换编辑器当前内容。

编辑过程中右侧预览区会实时刷新，所见即所得。

## 第二步：调整页面参数

顶部一排参数控制 PDF 的排版效果：

- **主题**：☀️ 明亮适合打印，🌙 暗黑适合屏幕阅读；
- **页面尺寸**：A4（国内通用）或 Letter（美式）；
- **方向**：纵向适合文档，横向适合宽表格和流程图；
- **边距**：拖动滑块调节，默认 10mm，打印装订建议 20mm；
- **字号**：默认 14px，调大更适合阅读，调小一页能装更多内容。

![编辑内容并调整参数](/api/file/download?path=article/202607/1783912242503_6064.png)

## 参数说明

| 参数 | 类型 | 可选值 / 范围 | 说明 |
| --- | --- | --- | --- |
| 文件上传 | 文件选择 | .md / .markdown / .txt | 上传后替换编辑器内容 |
| 主题 | 单选 | 明亮 / 暗黑 | 影响预览和导出配色 |
| 页面尺寸 | 下拉 | A4 / Letter | PDF 纸张大小 |
| 方向 | 单选 | 纵向 / 横向 | 页面方向 |
| 边距 | 滑块 | 毫米 | 默认 10mm |
| 字号 | 滑块 | px | 默认 14px |
| Markdown 源码 | 文本域 | 完整 Markdown 语法 | 支持代码/公式/Mermaid |

## 第三步：导出 PDF

预览区确认排版无误后，点击底部的「导出 PDF」按钮，浏览器会自动生成并下载 markdown.pdf 文件。实测包含代码高亮、KaTeX 公式和 Mermaid 流程图的示例文档，导出的 PDF 里全部完整保留。

![导出PDF](/api/file/download?path=article/202607/1783912254020_4124.png)

## 常见问题

**Q：公式用什么语法？**
A：行内公式用 $E=mc^2$，独立公式用 $$...$$ 包裹，采用 KaTeX 渲染，支持绝大多数 LaTeX 数学符号。

**Q：Mermaid 图怎么写？**
A：用三个反引号加 mermaid 标记代码块，内部按 Mermaid 官方语法写 flowchart、sequenceDiagram 等即可。

**Q：导出的 PDF 能编辑吗？**
A：导出的是标准 PDF，文字可选中复制；如需二次编辑可用本站的「PDF 页面编辑器」。

**Q：内容很长会不会分页错乱？**
A：导出时自动按页面尺寸分页，代码块和表格会尽量保持完整，建议导出前在预览区检查一遍。

## 总结与相关工具

Markdown 转 PDF 三步完成：写内容 → 调参数 → 导出下载。搭配以下工具可以覆盖更多文档场景：

- [Markdown编辑器](/tools/markdown_editor)：专注 Markdown 写作和预览；
- [Word转PDF](/tools/word_to_pdf)：Word 文档转 PDF；
- [PDF 页面编辑器](/tools/pdf_page_editor)：导出的 PDF 再删页、重排；
- [PDF 加水印](/tools/pdf_watermark)：给 PDF 添加文字或图片水印。