Markdown 转 PDF:免安装 3 种方法
写好的 Markdown 要交报告、发给客户或打印出来,最常见的需求就是转成 PDF。本文整理 3 种做法,从“打开网页就能转”到“用命令批量转换”都有。
最快的方法: 用墨阅打开 .md 文件,点击工具栏的“打印/另存为 PDF”,选择“另存为 PDF”即可。
方法 1:墨阅在线转 PDF(免安装,推荐)
适合大多数人:不用装软件,图表和公式都会保留,中文也不会变成方框。
- 打开墨阅,把
.md文件拖进窗口。如果文件引用了图片,请改用“打开文件夹”。 - 点击右上角工具栏的“打印/另存为 PDF”(下载图标)。
- 在打印窗口的“目标打印机”选择 另存为 PDF,点击“保存”。
建议的打印设置:
| 设置 | 建议值 | 原因 |
|---|---|---|
| 纸张尺寸 | A4 | 墨阅已针对 A4 排版 |
| 页边距 | 默认 | 墨阅已预留 16 mm 边距 |
| 页眉和页脚 | 取消勾选 | 避免打印出网址和日期 |
| 背景图形 | 勾选 | 保留代码块与表格底色 |
墨阅导出时会自动:
- 把 Mermaid 图表与 LaTeX 公式改用适合打印的浅色配色。
- 隐藏侧栏、目录与工具栏,只保留内容。
- 避免标题落在页尾,代码块和表格行不会被切成两半。
没有文件、只有一段文字? 打开 Markdown 在线编辑器粘贴内容,同样可以另存为 PDF。
方法 2:Visual Studio Code
如果你本来就用 VS Code 写 Markdown:
- 在扩展商店搜索并安装 Markdown PDF。
- 打开
.md文件,按Ctrl + Shift + P,输入“Markdown PDF: Export (pdf)”。 - PDF 会保存在同一个文件夹。
缺点是 Mermaid 图表与数学公式需要额外配置,中文字体也可能要调整。
方法 3:Pandoc(适合批量转换)
Pandoc 是专业的文档格式转换工具,适合程序员或需要大量转换的人。安装 Pandoc 与 LaTeX 引擎(如 MiKTeX、TeX Live)后运行:
pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="Microsoft YaHei"
- 用
--pdf-engine=xelatex才能正确处理中文。 CJKmainfont要换成电脑里已有的中文字体,Mac 可以用"PingFang SC"。- Mermaid 图表需要额外的过滤器,配置较复杂。
三种方法对比
| 墨阅 | VS Code | Pandoc | |
|---|---|---|---|
| 需要安装 | 不用 | 要 | 要(含 LaTeX) |
| 中文 | 直接正常 | 可能要调字体 | 要指定字体 |
| Mermaid 图表 | 支持 | 需配置 | 需插件 |
| 数学公式 | 支持 | 需配置 | 支持 |
| 批量转换 | 不适合 | 不适合 | 适合 |
常见问题
PDF 里的图片不见了?
在墨阅里请用“打开文件夹”,让图片和 .md 文件一起被读取;只打开单个文件时找不到旁边的图片。
可以控制分页位置吗?
墨阅会自动避免不好的分页。如果想在某处强制换页,目前建议把文档拆成两份分别导出。
手机可以转 PDF 吗?
可以。用手机浏览器打开墨阅,点击“打印/另存为 PDF”,iPhone 在分享菜单选择“打印”后再存成 PDF,安卓则在打印机选择“另存为 PDF”。详细步骤见手机打开 md 文件教程。
想转成 Word?
先按上面的方法存成 PDF,再用 Word 打开 PDF 即可转换;或者使用 Pandoc:pandoc input.md -o output.docx。