Markdown 转 PDF:免安装 3 种方法

写好的 Markdown 要交报告、发给客户或打印出来,最常见的需求就是转成 PDF。本文整理 3 种做法,从“打开网页就能转”到“用命令批量转换”都有。

最快的方法: 用墨阅打开 .md 文件,点击工具栏的“打印/另存为 PDF”,选择“另存为 PDF”即可。

方法 1:墨阅在线转 PDF(免安装,推荐)

适合大多数人:不用装软件,图表和公式都会保留,中文也不会变成方框。

  1. 打开墨阅,把 .md 文件拖进窗口。如果文件引用了图片,请改用“打开文件夹”。
  2. 点击右上角工具栏的“打印/另存为 PDF”(下载图标)。
  3. 在打印窗口的“目标打印机”选择 另存为 PDF,点击“保存”。

建议的打印设置:

设置 建议值 原因
纸张尺寸 A4 墨阅已针对 A4 排版
页边距 默认 墨阅已预留 16 mm 边距
页眉和页脚 取消勾选 避免打印出网址和日期
背景图形 勾选 保留代码块与表格底色

墨阅导出时会自动:

  • 把 Mermaid 图表与 LaTeX 公式改用适合打印的浅色配色。
  • 隐藏侧栏、目录与工具栏,只保留内容。
  • 避免标题落在页尾,代码块和表格行不会被切成两半。

没有文件、只有一段文字? 打开 Markdown 在线编辑器粘贴内容,同样可以另存为 PDF。

方法 2:Visual Studio Code

如果你本来就用 VS Code 写 Markdown:

  1. 在扩展商店搜索并安装 Markdown PDF。
  2. 打开 .md 文件,按 Ctrl + Shift + P,输入“Markdown PDF: Export (pdf)”。
  3. 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。