Markdown 导出 PDF 避坑指南：字族适配与防布局偏移

对于需要递交简历、发布技术白皮书或签署电子合同的用户而言，**PDF（便携式文档格式）**是最佳的跨平台最终格式，能确保文档在任何设备上“所见即所得”。

虽然市面上有许多 Markdown 转 PDF 工具，但在处理中文（CJK 字符集）或导出多页文档时，经常会遇到以下毁灭性的排版漏洞：

中文字符丢失与乱码：导出后所有汉字都变成了诡异的方框字（mojibake）或完全错乱的宋体替换。
页面边界强制截断：一行文字或表格行恰好位于分页符位置，结果直接被从中间横向切成两半，极其难看。
巨大的布局偏移 (CLS)：原本在网页上排得很好的样式，一生成 PDF 格式就发生崩溃，表格越界、字号异常。

本文将为您科普如何利用浏览器的原生打印通道与 FlowDoc 完美的 CSS 样式链，避开这些雷区。

🛠️ 避坑第一条：建立稳健的系统中文字体回退链 (Fallback Font Family)

要在导出的 PDF 中呈现清晰圆润的汉字，样式表决不能指定单一的非标准字体。FlowDoc 的排版系统在 @media print 样式中内置了针对中文字符的深度优化链：

font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, 
             "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", 
             "Source Han Sans SC", "Source Han Sans CN", "Noto Sans CJK SC", 
             sans-serif;

苹果生态 (macOS/iOS)：优先唤起无损的苹方（PingFang SC）与冬青黑体，确保字符边缘在 Retina 显示下圆滑自然。
Windows 生态：自动调用饱满有力的微软雅黑（Microsoft YaHei）。
开源与 Linux 生态：回退至思源黑体（Noto Sans CJK SC），完全杜绝因字体缺失导致的乱码方框。

📐 避坑第二条：善用 CSS 打印分页控制 (Print Page Breaks)

为了防止文章正文的标题和内容在分页处被暴力切断，我们在 FlowDoc 的隐藏打印沙盒中使用了高弹性的 CSS 属性控制：

/* 确保标题永远不和下方的段落分离，避免标题孤立在上一页页尾 */
h1, h2, h3, h4, h5, h6 {
  page-break-after: avoid;
  break-after: avoid;
}

/* 确保表格行、代码块以及块引用在分页时不会被从中间切断 */
tr, pre, blockquote {
  page-break-inside: avoid;
  break-inside: avoid;
}

通过这套 CSS 打印规则，当表格行或标题太长而一页放不下时，浏览器的打印引擎会自动将其推到下一页开始，从而保证了打印排版的绝对严整性。

🚀 极速上手：使用 FlowDoc 导出完美 PDF

步骤一：录入您的 Markdown

在 FlowDoc Markdown 转 PDF 页面输入您的 Markdown 源码。

步骤二：选择排版模板与样式

例如，如果是学术报告，勾选“学术论文”模板，如果是开发白皮书，勾选“技术方案”模板。系统会自动在后台的 iframe 中加载对应的排版规范与 CSS 变量。

步骤三：点击“导出为 PDF”

点击导出按钮，FlowDoc 会自动构建一个隔离的 HTML 打印沙盒，并调用原生系统 API window.print()。此时，浏览器会自动弹出系统级的打印预览窗口。

步骤四：在系统对话框中微调（关键步骤）：

在 目标打印机（Destination） 下拉菜单中，选择 另存为 PDF（Save as PDF）。
展开 更多设置（More Settings）：
- 纸张大小（Paper Size）：默认选择 A4 或 Letter。
- 页边距（Margins）：强烈建议选择 默认（Default），FlowDoc 的响应式 CSS 已经针对默认页边距进行了极致对称微调。
- 选项（Options）：务必取消勾选 “页眉和页脚（Headers and Footers）”以去除浏览器自带的网址和时间水印，务必勾选 “背景图形（Background graphics）”以完美渲染代码块的灰色底色和表格的交替底色。
点击保存，一份精美无暇、符合印刷规范的 PDF 文件便诞生了！