将 Markdown 转换为幻灯片

像编写 README 一样制作演示文稿:使用 Markdown 标题、项目符号列表和代码块,并以 --- 水平线分隔成一张张幻灯片。该工具借助 Reveal.js 实时渲染你的幻灯片(主题:黑色、白色、简约、solarized),通过 Note: 支持演讲者备注,通过 -- 支持嵌套的垂直幻灯片,并可导出为独立的 HTML 文件或可打印的 PDF。

Markdown 如何变成一套幻灯片

  1. 1

    编写 Markdown

    使用 `---` 分隔幻灯片。标准的标题、列表和代码块照常使用。

  2. 2

    添加演讲者备注

    在段落开头加上 `Note:`:它仅在演讲者模式下显示。

  3. 3

    预览幻灯片

    实时预览会显示整套幻灯片,并可用方向键导航。

  4. 4

    选择主题

    黑色、白色、league、sky、简约、solarized:任意 Reveal.js 主题皆可。

  5. 5

    导出

    独立的 HTML 文件,或通过浏览器打印生成的 PDF。

幻灯片语法

# 开场幻灯片

副标题文本

---

## 第二张幻灯片

- 要点一
- 要点二
- 要点三

Note: 这些是仅在演讲者模式下可见的演讲者备注。

---

## 代码幻灯片

\`\`\`python
def hello(name):
    return f"Hi {name}"
\`\`\`
  • ---(单独一行的三个连字符)开始一张新的水平幻灯片。
  • --(两个连字符)在当前幻灯片列内开始一张垂直幻灯片,按向下方向键即可向下切换。
  • 段落开头的 Note: 会变成演讲者备注。

键盘导航

按键 操作
右 / 空格 下一张幻灯片
上一张幻灯片
下 / 上 在垂直堆栈中导航
s 打开演讲者视图
o 幻灯片总览
f 全屏
? 帮助对话框

布局技巧

  • 双列布局: 在幻灯片中使用原始 HTML,<div class="columns">...</div>
  • 逐段显示: 直接使用 Reveal.js 时,项目符号列表会借助 {.fragment} 属性逐项动画显示;如需此效果,可作为原始 HTML 添加。
  • 背景图片: 幻灯片级别属性 <!-- .slide: data-background="url" --> 可设置满屏背景。
  • 幻灯片间自动动画: Reveal 4 支持匹配元素之间的平滑过渡,在主题设置中开启即可。

导出为 PDF

在实时预览中,于浏览器地址栏打开 ?print-pdf,并使用浏览器的打印对话框。选择 A4 横向、开启背景图形、页边距设为最小。Reveal.js 每页输出一张幻灯片,演讲者备注可选择性地显示在额外的页面上。

何时适合使用基于 Markdown 的幻灯片

  • 包含大量代码示例的技术演讲。
  • 内容优先、布局次要的幻灯片。
  • 以文档为幻灯片,将演示文稿与项目的 README 一起放在 git 中管理。
  • 纳入版本控制的培训材料。

何时不适合

  • 注重设计、需要精确摆放图片的主题演讲。
  • 需要复杂动画或嵌入式视频精确计时的幻灯片。
  • 由品牌统一管理、模板规定每处细节的幻灯片。

常见问题

可以,标准的 Markdown 图片语法即可使用。请使用绝对 URL,或先上传图片,以便在导出的 HTML 中能够正常访问。

会,可选。Reveal 的打印模式支持“备注作为单独页面”功能,每张幻灯片会生成两页 PDF,一页是幻灯片,一页是备注。

不会。渲染在你的浏览器本地进行。Markdown 源文件和导出的 HTML 绝不会离开你的设备。

可以。在 Markdown 顶部添加一个 <style> 块,或在主题设置中链接外部样式表,它会被注入到 Reveal.js 的输出中。

导出的 HTML 是一个独立文件,可在任意静态托管平台上运行,GitHub Pages、Netlify、S3。上传该 HTML 即可完成。

相关工具

此工具还提供其他语言版本