Markdown 幻灯片，免费

为什么要用Markdown制作幻灯片？

PowerPoint和Keynote擅长幻灯片设计，几乎在其他方面都表现欠佳。它们难以版本控制、难以差异对比、难以在手机上编辑、难以在团队中保持一致，也无法用grep搜索。Markdown在不争视觉设计的前提下解决了「其他一切」问题，对于技术内容（代码示例、终端输出、命令行演示、要点列表），它的编写速度比任何GUI工具都快。

格式是纯文本，因此天然支持git，可在任何编辑器中打开，可用从VS Code到vim到手机笔记应用的任何工具编辑，并能在30年的软件更迭中存活。权衡之处：您放弃了像素级的设计控制。对于开发者全员大会、技术会议演讲、README导览演示、课堂材料和闪电演讲，这是一个很好的权衡。对于销售演示和营销幻灯片，PowerPoint或Figma可能仍然更胜一筹。

---约定

独立一行的三个连字符是Markdown现有的水平线语法，最早在CommonMark中定义，并作为幻灯片分隔符在整个Markdown幻灯片生态系统中被复用，reveal.js、Marp、Slidev以及大多数小型工具都使用它。该约定无歧义（真正的水平线仍可在单张幻灯片内使用；---只有在独立一行时才会分割幻灯片），且易于输入。您将演示文稿写成一个连续的Markdown文档，工具会在视觉上重新分割它。

2026年的Markdown幻灯片生态系统

• reveal.js（Hakim El Hattab，2011年起），开创性的基于浏览器的演示库。支持垂直和水平幻灯片网格、过渡效果、演讲者注释（Notes:语法），以及通过data-markdown属性使用Markdown源码。这是家喻户晓的名字；slides.com将其作为SaaS托管。
• Marp：最流行的专用Markdown转幻灯片项目。基于CommonMark，附带CLI、VS Code扩展和Marp Core。出色的PDF导出功能。支持通过Frontmatter设置主题和宽高比。
• Slidev（Anthony Fu），较新（2021年），基于Vue，现代化。专为开发者演讲设计：内置代码高亮、幻灯片内代码嵌入、演讲者视图、演讲时在幻灯片上手绘。
• remark.js（Ole Petter Bang），极简，单文件嵌入。因不预设立场而受人喜爱。
• HackMD：协作编辑版本。基于浏览器，需要账号，跨设备同步。

此工具填补了一个不同的细分需求：无需安装、无需账号、无需上传。粘贴、演示、关闭标签页。当您在借来的笔记本上准备5分钟闪电演讲、在飞行中定稿幻灯片，或在会议室起草且不想启动Marp或登录slides.com时，它是最佳选择。

宽高比详解

现代幻灯片演示默认为16:9宽高比，过去十年建造的每个会议投影仪都是16:9画面，16:9与每台笔记本屏幕和现代电视相匹配。此处的视口以16:9渲染以匹配。旧版演示文稿使用4:3（CRT投影仪的原始宽高比）；旧款笔记本有时采用16:10。PowerPoint自2013版起默认为16:9；Google Slides创建时默认为16:9；Keynote的默认值也是16:9。

常见使用场景

• 开发者全员大会和演示日。带领团队了解代码变更、新架构或事故复盘。
• 技术会议和聚会演讲。特别是面向技术受众、演示文稿需要在Pull Request中差异对比干净的代码示例的演讲。
• README导览。对一个库的6张幻灯片介绍，嵌入项目文档中。
• 闪电演讲。5分钟、约5张幻灯片的演讲，仪式感是天敌。
• 课堂材料。边教边实时编辑幻灯片；学生可以复制Markdown源码作为笔记。
• 内部培训。与所教代码库并排进行版本控制和代码审查的入职演示文稿。
• 会前简报。以Markdown形式发送的3张幻灯片预读材料，收件人可在编辑器中预览。

即使在Markdown中也很重要的幻灯片设计原则

• 每张幻灯片一个观点。经典原则。如果一张幻灯片有两个想法，拆开。
• 少文字，多结构。如果幻灯片读起来像一段话，演讲者就是在念幻灯片。精简为要点，让演讲者补充细节。
• 字体要比您想象的更大。Markdown幻灯片默认正文字体约为24-32px等效大小。低于约18px的内容在会议室后排无法辨读。
• 每张幻灯片一个H1。同一张幻灯片上多个顶级标题会造成视觉混乱。
• 保持代码块简短。在16:9幻灯片上，六行大约是舒适的最大值。较长的代码片段需要拆分或分块高亮显示。
• 让每张图片都有其价值。装饰性的图库照片是填充物。图表、截图和数据可视化才是信号。

隐私

幻灯片演示文稿通常具有保密性，如融资演示文稿、内部战略、财务数字、发布前产品演示。此工具完全在浏览器中运行：Markdown保留在文本区域，渲染在本地进行，全屏演示从同一内存状态读取。不会上传任何内容，不需要账号，关闭标签页后一切都会清除。服务器托管的替代方案（slides.com、HackMD、GitPitch）需要信任运营方的数据处理政策；此工具完全消除了这一顾虑。

常见错误

1. 将整段文字粘贴到一张幻灯片上。如果观众在读，他们就没在听演讲者讲。拆分成要点。
2. 标题级别不一致。一张幻灯片用H1为标题，下一张用H2，看起来很随意。选择一个级别作为幻灯片标题并坚持使用。
3. 代码块对投影仪来说太长。30行代码片段在后排看不清。只展示相关的5-10行，其余部分用// ...代替。
4. 没有演讲者注释。幻灯片是观众的记忆辅助，而非您的。演讲者注释（在支持该功能的工具中）存放要点。
5. 忘记投影仪宽高比。如果您在16:10笔记本上创作，而场地使用4:3投影仪，内容会被裁剪。
6. 幻灯片切换效果过多。动画在演示中感觉精致，但在30分钟的演讲中会显得烦人。默认使用无过渡效果或简单的淡入淡出。
7. 使用在场地机器上无法显示的特殊字体。坚持使用系统字体，正文用无衬线字体，代码用等宽字体。

更多常见问题

可以将幻灯片导出为PDF吗？

可以，进入全屏模式，然后使用浏览器的打印功能（Ctrl/Cmd + P）并选择保存为PDF。大多数浏览器会将渲染后的幻灯片逐页打印为PDF。结果是简洁的文本PDF（而非图像），因此体积小且可搜索。

代码语法高亮怎么办？

围栏代码块以等宽字体和轻微深色背景渲染，使其在深色全屏主题上可读。每种语言的语法高亮（Python关键字一种颜色，字符串另一种颜色）需要更复杂的幻灯片框架，如reveal.js或Slidev。对于快速闪电演讲，这很少会被在意；对于代码密集的长篇演讲，这些工具更合适。

如何嵌入图片？

标准Markdown图片语法：![alt text](https://your-image-url.png)。图片必须可从公共网络访问（或通过file://网址从本地机器访问，但某些浏览器可能会阻止本地文件URL）。对于敏感图片，请使用Markdown的链接语法指向本地文件，在演讲时通过小型本地Web服务器提供。

可以离线使用吗？

页面加载后可以，Markdown渲染和幻灯片导航在本地运行。没有网络时外部图片无法加载，因此如果您将离线演示，请将图片嵌入为data URI或本地托管。

演讲时可以使用键盘吗？

可以，方向键/空格键前进，退格键后退，Escape退出全屏，F切换全屏。大多数演讲遥控器（标准Logitech无线演示器等）模拟相同的方向键，因此无需配置即可使用。

有任何内容会发送到服务器吗？

不会。Markdown渲染、幻灯片分割、全屏演示，都在您的浏览器中进行。您的演示内容不会被上传、记录或存储在服务器端的任何地方。关闭标签页会清除文本区域内容。