将 Markdown 转换为 PDF,文档内容不丢失
Markdown 是为滚动屏幕而设计的,而 PDF 有分页和边界。大多数转换器忽略了这种差异:它们只是把文件交给浏览器,点击打印,然后返回随便生成的结果。这就是为什么表格会丢失最后四列,标题会被孤零零地留在页面底部,README 顶部的 logo 会变成一行原始 HTML 代码被当作文本打印出来的原因。MiniPNG 先为纸张重新排版文档,并告知你为此做了哪些调整。
适合纸张的表格
Markdown 表格本身没有列宽,语法也无法指定。因此,直接交给浏览器渲染的转换器只能碰运气,表格能否适合页面全靠运气。MiniPNG 会在绘制前测量每个表格,并根据你选择的纸张调整大小。即使是十四列宽的文件路径表格,也能保持在页边距内,长内容会自动换行而不会溢出,结果中也会说明做了哪些调整。
另一个常见问题出现在第二页。长表格通常会把表头留在第一页,后面的页面只剩下没有标签的数据。MiniPNG 会在每一页都重复表头,并且不会让任何一行被分页截断。
代码块不会被边距截断
带围栏的代码块会保留高亮和语言标签。过长的代码行会自动换行,且能清楚看到换行,而不是被页面边缘裁剪。PDF 没有滚动条,不能换行的代码行右侧内容就会丢失。缩进块、无语言的围栏代码块和内联代码都会被正确还原。
README 里的图片
logo 和一排构建徽章几乎从不直接用 Markdown 书写。由于无法居中图片,README 文件通常会用原始 HTML。拒绝渲染 HTML 的转换器通常会将其转义,导致文档开头变成一堆图片标签文本。MiniPNG 会去除多余标记,保留图片和其中的文字,让文档顶部看起来和原始一致。
图片会被抓取并嵌入到文件中,而不是仅仅链接,这样 PDF 离线也能正常显示,并且一年后依然有效。如果图片无法获取,结果中会统计并告知,而不是悄悄留下空白。
你的标题变成导航
每个 PDF 都会根据你的标题生成书签树,长文档可以通过侧边栏导航而无需滚动。你可以选择生成目录页,并指定目录的标题层级。最顶部的单一标题会被识别为文档标题,不会出现在目录中,就像书籍的标题而不是章节标题一样。
脚注依然是脚注,带有上标和返回原文的链接。任务列表保留勾选框,无论是否已勾选。提示、警告和注意等标注保留彩色边栏。文件顶部的 front matter 作为元数据处理,不会出现在页面上。定义列表、删除线、嵌套引用和最多三层嵌套列表都能正确渲染。
告知你哪些内容无法处理
每次转换都会附带简要说明:页数、文本方向、表格数量、代码块数量、嵌入图片数量及无法获取的图片数量。如果字体缺少某个字符,也会列出具体字符。如果你要求生成目录页但文档没有可用标题,也会明确说明,而不是给你一个空白首页。隐藏失败的转换器才会让人失去信任。
支持非拉丁文字
字体会被嵌入 PDF 文件,即使在没有安装这些字体的电脑上也能正常打开。右到左的文本会按区块判断方向,而不是整篇文件统一处理,这对于技术文档尤其重要,因为这类文档常常一半是拉丁字符(如文件路径、类名),但整体依然从右到左。带围栏的代码块始终从左到右显示,其他布局元素如项目符号、引用条和表格列都会正确镜像。对于没有斜体的文字,强调会用加粗而不是倾斜。
不会做的事情
不渲染 LaTeX。美元符号包裹的块会原样输出为文本。也不渲染 Mermaid:标记为 mermaid 的围栏代码会作为带标签的代码块输出,而不是绘制成图表。中文、日文和韩文超出了内置字体范围,这些字符会被报告为缺失,而不会随意猜测。这些是已知限制,而不是缺陷,在这里明确说明,避免你上传后才发现。
实用操作
可以从本地设备上传、从 Google Drive 上传,或粘贴文件链接。Markdown 文件支持所有常见扩展名,纯文本也可以。纸张可选 A3、A4、A5、Letter、Legal 或 Tabloid,纵向或横向,边距可选窄、普通或宽。页码和语法高亮默认开启,可手动关闭。上传单个文件会返回 PDF,上传多个文件会返回 ZIP,或按需合并为一个 PDF 并连续编号。文本始终保持为可编辑文本,可选择、搜索和复制,而不会变成图片。
你将获得
- 始终保持在页边距内的表格,表头在每页重复
- 语法高亮的代码块,长行自动换行而不会被截断
- 图片嵌入文件,包括用原始 HTML 编写的图片
- 根据标题生成书签树,可点击的目录页(按需生成)
- 字体嵌入 PDF,文件在任何设备上都能保持一致显示
- 详细记录转换器无法处理的内容,包括缺失字符和图片
下一步怎么做?
需要从 Word 文件开始?Word 转 PDF 采用同样的纸质排版方式。 用 合并 PDF 把结果和报告的其他部分组合在一起。 发送前可用 压缩 PDF 减小文件体积。