简洁、商务、学术与深色：该选哪款 md2pdf 主题？

md2pdf 中的主题选择器看起来只是个小决定：导出按钮上方的四个单选按钮。但实际上，它会在读者接触内容之前，先改变文档的阅读气质。用学术主题打印的规格文档像一篇论文；用简洁主题打印的客户提案则像仓库内容的直接倾倒。合适的主题，是符合读者期待的那一个。

四款主题渲染的是同一份 Markdown。它们的差异在于字体族、对齐方式、代码样式、表格样式、链接颜色，以及为标题增添多少视觉结构。它们都不会添加水印、封面页或徽标。内容始终属于你。

主题是打印样式表，不是换色

每款主题都是一组应用于预览纸张并带入打印输出的 CSS 规则。这意味着主题会影响：

• 标题、正文、表格和代码所使用的字体。
• 正文是左对齐还是两端对齐。
• 标题分隔线的颜色与粗细。
• 代码块和行内代码的背景。
• 表头填充色与边框颜色。
• 链接在预览中的颜色，以及在 PDF 能够保留时的导出文件中的颜色。

打印样式表还处理分页提示：代码块、表格、引用块和图片尽可能避免从中间断开，标题也尽可能避免孤悬在页面底部。

比较之前有一个实用提示：如果希望代码块填充和表头颜色得以保留，请在浏览器打印对话框中启用背景图形。关闭后 PDF 仍可阅读，但商务和深色主题会失去部分结构。这个选项在打印对话框中，而不在应用里。

简洁：技术文档的默认之选

简洁是中性选项。整份文档使用界面本身的无衬线字体栈，白底深灰文字，搭配浅灰代码背景。标题由细线分隔，链接使用产品其他位置一致的蓝绿色。

最适合：

• 仓库 README 与技术规格文档。
• 内部工程文档。
• 代码密集的讲义与运行手册。
• 在屏幕上阅读与在纸上阅读频率相当的文档。
• 中性比精致更重要的审计快照。

需要注意：

• 很长的论述可能显得平淡。简洁追求效率，而非温度。
• 浅色代码背景在打印时依赖背景图形。若被禁用，代码块仍可阅读，但会失去与正文的视觉区隔。
• 在较小的打印字号下，无衬线正文长时间阅读可能不如衬线字体舒适。

简洁是最稳妥的默认选择，因为它不强加任何语气。如果你要为另一位工程师导出 README，从这里开始。

商务：报告、提案与面向客户的交付

商务主题让文档进入更正式的语域。它通篇使用衬线字体、带较粗分隔线的藏青色标题、深色代码块和带底色的表头。成品读起来更像报告而非 README——当读者是客户、管理者或跨职能相关方时，这正是重点。

最适合：

• 客户交付与项目概览。
• 提案、工作说明书和报告。
• 希望显得经过设计的研讨会讲义。
• 作品集附件和申请样例。
• 图表与表格和正文同等重要的文档。

需要注意：

• 深色代码块是很强的视觉元素。包含大量短代码片段的文档可能开始显得条纹化。
• 衬线字体和接近两端对齐的间距会让长 URL 与代码标识符格外突出。尽量保持代码行简短。
• 背景图形在这里很重要。关闭后，深色代码块会变成普通色块，表头也会失去底色。
• 商务主题不能替代编辑。未经整理的更新日志，用商务主题打印仍然像未经整理的更新日志。

对外文档通常用商务主题能留下更好的第一印象。它表明这份 PDF 是为读者准备的，而不是随手导出的产物。

学术：长篇论述与课程材料

学术主题使用衬线字体、两端对齐的正文，以及更温暖、更浅的代码样式。标题保持左对齐，因此即便段落两端对齐，结构仍然便于扫读。整体效果更接近课程读本或论文，而非产品页面。

最适合：

• 课程资料包、阅读材料和讲义。
• 论文与研究写作。
• 代码块较少的长篇文档。
• 基金申请与学术作品集。
• 读者期望连续阅读而非快速浏览的任何文档。

需要注意：

• 两端对齐可能在长 URL、代码标识符和技术术语周围产生较大空隙。请把长链接改为引用式链接，或移入列表。
• 代码块可读，但视觉上比商务主题安静。这是有意为之：学术主题假定代码是辅助材料，而非主角。
• 如果表格列数较多，在 A4 上可能显得局促。请减少列数，或把细节移入正文。
• 学术主题不适合快速上手指南。这种版式传达的是“请从头读到尾”，而运行手册通常是用来查找的。

如果文档包含类似参考文献的章节，学术主题的排版会让它显得恰如其分。应用不会格式化引文，因此请把参考文献章节保留在 Markdown 中。

深色：屏幕优先审阅，打印安全输出

深色是其中的异类。它首先为舒适的屏幕阅读而设计：深海军蓝背景、浅色文字和更明亮的链接颜色。打印时，打印样式表会强制使用白色背景、黑色文字、黑色链接和浅色代码块。PDF 不会把深色屏幕主题带上纸面。

最适合：

• 导出前在屏幕上审阅长 README。
• 夜间或弱光环境阅读。
• 检查文档在没有白页视觉干扰时的阅读效果。
• 为偏好深色模式工具的团队生成 PDF。

需要注意：

• 屏幕上看到的效果，并非 PDF 中得到的效果。请始终打开导出文件确认浅色打印处理。
• 深色不是对外文档的品牌主题。客户期待 PDF 与打印输出一致，而不是与预览一致。
• 如果你的浏览器设置为打印背景，打印样式表仍会覆盖深色表面，但代码块可能需要目视检查。
• 该主题的屏幕对比度可能掩盖薄弱的源结构。标题层级混乱的文档看起来仍有氛围，但并不会因此变得更有条理。

请把深色视为一种阅读模式，附带打印安全的出口，而不是最终文档的第四种视觉身份。

并排比较

	简洁	商务	学术	深色
正文字体	无衬线	衬线	衬线，两端对齐	屏幕无衬线；打印浅色
标题处理	细线	藏青线条	左对齐衬线	深色底浅色线条；打印安全
代码块	浅灰	深海军蓝	温暖浅色	屏幕深色；打印浅色
表头	中性	蓝色底纹	中性	屏幕深色；打印浅色
链接颜色	蓝绿色	蓝色	黑色	屏幕亮蓝；打印黑色
最佳受众	工程师	客户、管理者	学者、学生	作者本人，屏幕上
最佳文档	规格、README、运行手册	报告、提案、讲义	论文、课程包	审阅副本

这张表只是起点，不是规则。技术型客户可能更偏爱简洁，注重设计的工程团队可能更偏爱商务。文档要完成的任务，比它所属的类别更重要。

主题如何与导出的其他环节相互作用

主题只是打印结果的一部分。以下交互值得检查：

目录。 目录继承文档的字体和链接颜色。在商务主题中，藏青色标题和蓝色链接让它像报告目录页；在学术主题中，它读起来像论文大纲。目录会为含三个及以上标题的文档生成，短文档可以关闭。

代码块。 简洁和学术使用浅色代码背景；商务使用深色块；深色在屏幕上使用深色块，打印时使用浅色块。比颜色更大的问题是长行。无论哪款主题，120 个字符的行都会溢出。

表格。 商务主题会添加带底色的表头；简洁和学术保持中性。宽表格是最常见的打印失败原因。如果表格超过五到六列，请考虑拆分它，或缩小源文件字号，而不是降低打印缩放。

图片与徽章。 主题不改变图片渲染，但会改变周围的留白。商务的衬线正文会让截图更像插图；简洁的无衬线正文则让它更像文档。损坏的图片会在预览中标记，且不会中止导出。

链接。 简洁和商务使用蓝色链接；学术使用黑色；深色在屏幕上使用亮蓝，打印时为黑色。如果 PDF 将以灰度打印，颜色差异会消失，因此请让链接文字本身具有描述性，而不要依赖颜色。

分页。 打印样式表尽可能防止代码块、表格、引用块和图片在元素中间断开，并让标题跟随其后的内容。这一行为在所有主题中一致，但在学术主题中更重要，因为长篇论述会产生更多翻页。

30 秒内做出选择

使用这条快速决策路径：

1. 读者是会查找命令和代码的工程师吗？ 选择简洁。
2. 读者是期待报告格式的客户、管理者或审阅人吗？ 选择商务。
3. 文档是代码块较少的长篇论述吗？ 选择学术。
4. 你主要在屏幕上阅读，之后才导出吗？ 选择深色，然后检查 PDF。
5. 仍然拿不准？ 选择简洁。它最不容易让文档显得名不副实。

一个有用的测试：用两款候选主题分别导出前两页，然后在手机上阅读。能在小屏幕和快速浏览中胜出的主题，通常就是正确的选择。

比主题更重要的导出前检查

没有哪款主题能修复这些问题：

• 标题层级。 主章节用 ##，子节用 ###。跳级会让目录变得混乱。
• 代码行长度。 尽可能将每行控制在约 80–90 个字符以内。
• 表格宽度。 减少列数、缩短标签，或拆分表格。
• 图片路径。 仓库相对图片需要先获取仓库；粘贴的 Markdown 需要使用绝对 URL。
• 机密文本。 转换在本地进行，但 PDF 仍然可以被转发。
• 页面尺寸。 A4 与 Letter 的分页方式不同。请选择收件人将要打印的那一种。
• 背景图形。 如果代码块填充和表头对设计很重要，请启用它。

建议

对于大多数 README 导出，简洁是正确的默认选择。它中性、易读，不会假装文档是别的东西。当 PDF 是交付给工程部门以外某人的成果时，使用商务；当文档需要作为论述性文字阅读时，使用学术；当你想在生成最终浅色 PDF 之前舒适地审阅一遍时，使用深色。

主题是给读者的信号。选择与任务匹配的信号，然后把剩余精力花在内容上：清晰的开篇、合理的标题结构，以及真正能加载出来的图片。这些选择在任何主题下都成立。

完整导出流程请参阅如何将 GitHub README 转换为 PDF。针对特定受众的准备方法，请参阅将 README 转为 PDF 的 7 个实用场景。