
幻灯片转换器,其实是套了演示文稿外壳的正则表达式。我用 14、20、32 像素三种字号渲染同一份文稿,在真实浏览器里逐个元素量尺寸:15 类元素里有 11 类纹丝不动。这个工具的七个控件里有两个近乎失效,偏偏它们是你最先会去调的那两个。
转换器究竟做了什么
四步,仅此而已。它剥掉文件顶部的 YAML 前置数据,把剩下的内容按一条正则切开,这条正则只认「整行三个连字符」。每段幸存下来的片段交给 Showdown 处理。这是一个 Markdown 转换器,开了表格、删除线、GitHub 风格代码块和自动链接识别,emoji 转换关着。最后,每个片段被包进一个 section 元素,套上一份固定样式表,交给 Chrome 按一节一页打印。
这条流水线里没有演示引擎。没有排版算法,没有自动适配,没有文字缩放启发式。也没有图片规则和表格规则:样式表只定义了标题、段落、列表、链接、代码、引用块和页脚,到此为止。一张幻灯片就是一块固定尺寸的 HTML,一个页面就是装下它的固定尺寸矩形。
两种页面尺寸是写死的。16:9 渲染成 1280×720 像素,4:3 渲染成 1024×768。每张幻灯片正好变成一页,因为每个 section 都带着分页规则。九张幻灯片进去,九页出来。我导出了一份文稿,数了数 PDF 里的页面对象,确认了这个数。
这套设计本身合理,而且也就是它的全部了。
分隔符是正则表达式,不是解析器
切分时找的是被换行夹住的、正好三个连字符的一行。它不是 Markdown 块解析器,也不管自己切开的到底是什么。
我拿这个工具自己的切分逻辑,去跑同一份两页文稿的四种写法。以一行三个连字符开头的文稿,第一张幻灯片直接消失:前置数据提取器把开头的连字符当成分隔,向后扫到下一个,把封面页当成元数据吞掉了。这份文稿只剩一张幻灯片。
同样的三个连字符出现在围栏代码块里,会把代码块劈成两半,切出三张幻灯片,YAML 被撕到两张里。这里没有转义通道,因为正则根本不看围栏标记。举例来说,这份文稿的内容依次是 ---、title: Deck、---、# Slide One、---、## Slide Two。
提取器把 title: Deck 当成前置数据,切分器再在两个标题之间的分隔处下刀。两张幻灯片,符合预期,但前提是前置数据先被剥掉了。要是开头那行连字符去掉,封面页就会反过来被当成元数据吞掉。
五个连字符不切分:模式要求的正好是三个,多出来的字符会让匹配失败。两个空格的缩进照样切分,连字符后面的尾随空格也照样切分。只有字面写法起作用,而且只在这个最窄的意义上起作用。
对一份真在用的文稿来说,结论很简单。三个连字符就是分页符,任何位置、任何时候都算,包括你的代码示例里面。工具自己找不到可切之处时的报错就承认了这一点:"No slides found. Use --- to separate slides."
前置数据被提取出来,然后扔掉
前置数据的处理,最能说明界面和输入之间的落差。提取器识别出文件顶部的 YAML 块,把它抽出来,然后丢掉。HTML 构建器只拿到幻灯片片段,前置数据根本到不了渲染器。

这件事要紧,因为这个工具模仿的文稿方言是 Marp,而 Marp 完全靠前置数据配置。工具自带的示例文稿开头有六个键:marp、theme、paginate、size、title、description。一个都不会被读。size: "16:9" 不决定幻灯片尺寸,尺寸来自另一个下拉框。paginate: true 不打开页码,页码由另一个复选框控制。theme: default 不选主题,因为总共只有两套,下拉框把其中一套叫 light。title 从头到尾不会出现在幻灯片上。
前置数据唯一剩下的职责,是把自己删掉。它是披着配置文件外衣的开头剥离器。
基准字号滑块只动三样东西
面板提供 14 到 32 像素的基准字号,这是设置与输出分歧最明显的控件。样式表把这个字号设在幻灯片容器上,随后又用 rem 给几乎每个子元素单独定值。rem 相对根字号解析,不看容器。标题、段落、列表项、行内代码和页脚全部被钉在各自的数值上。

我用 14、20、32 像素渲染同一份文稿,在真实浏览器里量每个元素。结果如下。
- h1 标题三种设置下都量到 41.6 像素,不随滑块变化。
- h2 标题三种设置下都是 32 像素,不随滑块变化。
- h3 标题三种设置下都是 24 像素,不随滑块变化。
- 正文段落三种设置下都是 17.6 像素,不随滑块变化。
- 列表项三种设置下都是 16.8 像素,不随滑块变化。
- 行内代码三种设置下都是 16.72 像素,不随滑块变化。
- 幻灯片页脚三种设置下都是 13.6 像素,不随滑块变化。
- 引用块依次是 14、20、32 像素,跟着滑块走。
- 代码块依次是 14、20、32 像素,跟着滑块走。
- 数据表格依次是 14、20、32 像素,跟着滑块走。
我量过的 15 类元素里,11 类纹丝不动。滑块从 14 拉到 32,变大的是你的代码示例,幻灯片本身没动。行内代码是固定值里最容易被忽略的一个:它的 em 值相对段落解析,不看滑块,所以你设什么都是 16.72 像素。
「打印背景」是空操作,这反而是好事
面板上第二个失效开关,是标着「打印背景」的复选框。这个选项通常决定页面打印时带底色还是走纯白。我把同一份文稿导出了两次,一次勾上,一次不勾,然后对比结果。

两次输出在每一处要紧的地方都一致:页数相同,字节长度相同,渲染像素相同。只有 PDF 元数据里的创建时间戳不一样。
原因在样式表:它在 page 元素上写死了 print-color-adjust: exact。这条声明告诉打印引擎保留背景色,不管打印背景的开关有没有打开,而且它说了算。为了确认机制而不是靠推断,我把这条声明去掉重新导出:复选框不勾时,深色主题的背景消失,页面变成白底。把声明放回去,深色页面又回来了。页面区域的深色像素占比从 99.6% 掉到 0.0%,然后又回升了。
有一点值得记住。单看这个复选框,它是个该报的 bug,因为白底白字等于幻灯片彻底看不见。由于样式表把行为钉死了,这个失效的复选框目前无害。设置失灵,救你的正是这份失灵。
方言是 Showdown,不是 Marp
Markdown 这一侧是带固定选项集的 Showdown,值得弄清这套选项包含什么、不包含什么。
表格能转,而且转得正确,会得到带表头和表体的 table。但样式表里没有一条规则管它们,所以出来没有边框、没有内边距,投到幕布上就像一张丢了格式的电子表格。emoji 短码完全不转::smile: 会原样以那几个字符出现在幻灯片上。任务列表同样不转,勾选项渲染出来带着字面的方括号和空格。Remark 的演讲者备注语法不受支持,用 ??? 围起来的块会当成普通段落文字渲染,连标记一起显示。
波浪号围栏是有效的,工具自带示例文稿的 TypeScript 幻灯片就是这么写的。裸 URL 会自动变成链接。另外,Showdown 会给渲染的每个标题分配 id,所以两张标题同名的幻灯片,会在同一页上产生两个标识符相同的元素。
还有哪些设置有效,该怎么用
这些都不说明工具差。它只是很具体,而具体一旦被摸清就可以用。真正该伸手去调的,是那些说到做到的设置:主题给你两套真实配色,幻灯片尺寸给你两个真实页框,页码复选框给你一个 1 / 9 页脚,尺寸 13.6 像素,你想要不想要都是这个数。
绕开的办法同样具体。写文稿时别让开头是三个连字符。前置数据一个字都别写。代码示例的字号靠容器去调,其余元素就当它们不动。深色主题就当它会打印成深色,事实也确实如此。表格写成散文,或者接受它们不带样式。
整套流程跑起来是什么样,可以在 Markdown幻灯片转PDF 上看。示例集 Markdown 幻灯片示例 里带了一份入门文稿,练到了标题页、编号议程、指标表、代码页和引用页。如果你自己的 PDF 出自另一条流水线,又需要同样形态的输出,Markdown转PDF主题包 处理的是文档而不是幻灯片,PDF页眉页脚片段 则给你能控制的 HTML 加上可复用的页眉页脚。更广的 文档工具合集 覆盖转换链的其余部分。
正则渲染需要留逃生口
我本来只打算把两个坏掉的复选框列个单子给你。结果找到的是一个比单子更有用的模式:看得见的控件只是装饰,Markdown 才是契约,样式表是你够不到的那部分。
这不是这个转换器独有的缺陷。任何渲染流水线只要是拿一条正则加一份样式表搭起来,再有人为了让它看起来像个成品挂上一面板旋钮,都会是这个样子。
带到这一类下一个工具面前的问题,不是它的选项有什么用。是它的解析器能接受什么,它的 CSS 写死了什么,这两者里哪一部分设置改得动。问清这三件事,你会在撞上坏掉的幻灯片之前先找到那些失效的开关。
所以从面板承诺的设置起步,拿这三个问题去对源码。要是一个下拉框给了两个选项,CSS 却写死了第三种,那你不用导出 PDF 就已经得到答案了。
我以为面板描述的是渲染器。它什么也没描述,文稿照样渲染出来了。真正的问题是下一个工具的面板会宣称什么、它的哪个旋钮根本没接上;你写了什么,就得到什么。
Pingback: Why 2 of 7 Markdown Slide Settings Do Almost Nothing - COSESAI