Markdown 转换 PDF 避坑与注意事项指南
本编辑器支持一键将排版优雅、带有图表和公式的文档完美导出为 PDF 格式文件。请跟随以下步骤配置以获得最佳排版。
🛠️ 分步导出 PDF 教程
1
点击导出 PDF 选项
在编辑器右上角的导航栏点击 导出文件 按钮，或者在左侧侧边栏的文档列表中，将鼠标悬停在对应文档上并点击其右下角的 导出图标。在弹出的选项框中，点击 “导出 PDF 文档 (.pdf)”。
2
目的地选择“另存为 PDF”
系统会自动调出浏览器自带的打印预览配置窗口。如果您的电脑连接了实体打印机，请在 “目标打印机”（或“目的地”）下拉菜单中，将其手动切换为 “另存为 PDF” (Save as PDF)。
3
关闭“页眉和页脚”（非常重要）
在打印窗口中点击展开 “更多设置” (More settings)。找到 “页眉和页脚” (Headers and footers) 选项，务必将其取消勾选。这样可以隐藏 PDF 页面顶部默认渲染的日期网址以及底部的临时文件名，让导出的文档非常干净专业。
4
调整“边距”和“纸张尺寸”
- 纸张尺寸：默认选择 A4（根据您的受众也可以选择 Letter 尺寸）。
- 页边距：通常选择 “默认”。如果包含非常宽的表格或数学公式，建议选择 “自定义” 并手动拖动两侧调节线以留出最舒适的阅读空白，或选择 “无边距”。
⚠️ 常见踩坑注意事项与解决方法
🌙 深色主题打印设置提示
如果您的编辑器当前处于 “暗黑主题” 状态：- 请确保在“更多设置”中勾选了 “背景图形” (Background graphics) 复选框，否则代码块背景色、表格条纹和一些图标将无法呈现在 PDF 中。
- 省墨建议：如果需要实体打印该 PDF，建议在点击导出前，先点击右上角的太阳/月亮图标将编辑器切回 “浅色模式”，然后再导出。
📊 Mermaid 流程图与公式缺失？
如果导出的 PDF 中有个别数学公式或 Mermaid 关系图显示不全或未渲染：这是因为浏览器打印预览时仅渲染已进入视图视口内的图表。在点击导出前，建议先在编辑器中将文档从头到尾快速向下滚动一遍，确保页面内所有 KaTeX 和 Mermaid 图表都已完全加载完毕。