Markdown 转 PDF：排版、分页、表格与代码

先把 Markdown 写成清楚的文档

清楚的大纲是干净 PDF 的基础。整篇文档使用一个主标题，主要章节按 H2 展开，必要时再用 H3。段落不要过长，列表、表格、引用和代码围栏前后留空行。

链接使用描述性文字，图片写清楚替代文字。这样即使图片加载失败或打印成黑白，读者仍知道那里应该是什么。

• 一个 H1 作为文档标题，H2 表示主要章节
• 不要把长 URL 直接塞进正文，使用说明目的的链接文字
• 控制表格列数和单元格长度
• 代码围栏后写语言名，便于高亮和阅读
• 使用稳定 HTTPS 图片地址并填写替代文字

在线把 Markdown 转成 PDF 的步骤

最稳妥的流程分成两次检查：浏览器里看内容，下载后看页面。

1. 打开 Markdown 转 PDF粘贴内容、加载示例，或打开 .md、.txt 文件。
2. 检查浏览器预览修复标题层级、缺失空行、错误表格、图片地址和代码围栏。
3. 下载 PDF等待字体、图片和页面生成完成，不要在下载过程中关闭标签页。
4. 打开成品逐页检查查看分页、表格宽度、代码换行和图片是否出现。

宽表格如何放进 A4 页面

表格是最容易在 PDF 中出问题的元素。屏幕可以横向滚动，纸张不行。超过四五列、每格又有长句的表格，在 A4 纵向页面中很难保持可读。

先缩短列名和单元格，只保留比较所需的信息。一个超宽表格往往可以拆成两张：第一张放身份和状态，第二张放详细指标。若表格本身用于计算，应该提供 Excel 或 CSV，而不是强迫 PDF 承担电子表格工作。

代码块为什么会换行或被截断

浏览器代码块可以横向滚动，但 PDF 页面通常会换行或截断。命令、路径和 JSON 若一行过长，应该在不改变语义的位置拆行。

代码围栏完整闭合，并在开始围栏后写 `javascript`、`bash`、`json` 等语言名。高亮可以改善阅读，但不是保证；最终仍以下载文件为准。

• 优先展示最小可运行片段
• 避免把压缩后的 JSON 放在一行
• 检查长 URL、文件路径和命令参数
• 不要用截图替代需要复制的代码

远程图片为何可能不出现在 PDF 中

生成 PDF 时，浏览器必须能够访问图片。需要登录、带短期签名、限制跨域或已经失效的地址，可能在编辑器里偶尔可见，却无法稳定写入成品。

正式材料应使用稳定资源并尽早测试。如果图片来自内部系统，先按组织规定处理，不要为了方便把敏感图片改成公开地址。当前工具不提供上传图片到托管服务的承诺。

怎样减少难看的分页

标题孤零零出现在页尾，会让下一页的正文难以跟读。浏览器没有手动分页控制时，最实际的方法是控制内容块长度，并提前生成成品。

长代码块和表格不一定能优雅拆开。不要靠在 Markdown 中插入大量空行推内容到下一页，这种做法遇到字体或图片变化就会失效。

• 确认标题没有孤立在页尾
• 逐张检查远程图片
• 检查宽表和长代码是否仍可读
• 把重要链接写成可识别文字或可见 URL
• 查看最后一页是否出现意外大片空白

PDF、Word 和 HTML 应该怎么选

PDF 用于固定呈现和打印；Word 用于评论、修订和继续排版；HTML 用于网站和 CMS。保留 Markdown 源文档，可以按接收场景生成不同输出，不必维护三份容易失去同步的正文。

PDF 下载后的最终检查清单

正式发送前，用实际阅读软件打开文件，不要只相信生成成功提示。

• 文件能正常打开，页数合理
• 第一页标题和作者信息完整
• 没有标题落在页尾而正文从下一页开始
• 表格没有横向截断
• 代码没有丢字符
• 图片清楚并带正确说明
• 重要链接写明目的，必要时显示完整 URL
• 中文字体没有方框或缺字

相关工具