我用 Markdown 编写所有内容：博客文章、文档、会议记录、项目提案。但客户和利益相关者想要 PDF 格式。这种转换本应很简单，但任何尝试过的人都知道，格式常常会以各种方式出错，轻则令人烦恼，重则彻底毁掉文档。
为何转换比看上去更困难
Markdown 是一种专为生成 HTML 而设计的文本格式。PDF 则是一种面向打印的、基于页面的格式。这两种格式在渲染模型上存在根本性差异。
HTML 是流式布局。内容会在视口宽度处自动换行，没有页面边界的概念。Markdown 继承了这一模型。
PDF 是分页的。内容必须适配特定的页面尺寸。超出页面的内容必须在页边处断开。PDF 中存在页眉、页脚和页码，而 Markdown 中并无对应概念。
转换过程必须在这两种模型之间架起桥梁，而这座桥上却布满裂缝。
代码块溢出
最常见的格式问题出现在代码块上。Markdown 代码块的宽度可以任意延伸。在 HTML 中，它们会横向滚动；但在 PDF 中，没有横向滚动功能。一旦某行代码超出页面边距，要么被裁剪（部分代码不可见），要么在语法中间强制换行（破坏可读性），要么缩小字体以适应页面（导致难以阅读）。
最佳做法是：当你知道输出目标是 PDF 时，应将代码块控制在每行 80 个字符以内。这本来就是良好的编程习惯，而在生成 PDF 时更是必不可少。
# 这些代码在标准 PDF 页面上使用 10号等宽字体时能完整显示
function short() { return true; }
# 这段代码会溢出并引发问题
function thisIsAVeryLongFunctionNameThatDemonstratesWhyYouShouldKeepLinesShort(parameterOne, parameterTwo, parameterThree) { return null; }
表格渲染
Markdown 表格是第二大痛点。在网页上显示正常的宽表格，在 PDF 中要么超出页面边界，要么压缩各列，导致单元格内容无法阅读。
对于 PDF 输出，建议最多只使用 4 到 5 列，并保持单元格内容简洁。如果确实需要更宽的表格，可考虑将其拆分为多个较窄的表格，或将页面方向调整为横向。
图片尺寸
在 HTML 中，图片尺寸由 CSS 和浏览器视口决定。而在 PDF 中，图片需要明确指定尺寸。一个在屏幕上显示正常的全宽 Markdown 图片，在 PDF 中可能会显得异常巨大，把其他所有内容都挤到后续页面。
大多数 Markdown 转 PDF 工具都支持图片尺寸设置语法：
{width=
免责声明：本文内容来自互联网，该文观点不代表本站观点。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，请到页面底部单击反馈，一经查实，本站将立刻删除。
