告别PPT!MDX Deck完全入门:用Markdown+React快速打造高性能网页演示文稿
告别PPT!MDX Deck完全入门:用Markdown+React快速打造高性能网页演示文稿
MDX Deck 是一款基于 Markdown + React 的开源网页演示文稿框架(React MDX-based presentation decks)。它让你用纯 Markdown 编写幻灯片,用 React 组件嵌入交互内容,用零配置 CLI 一键启动,还能拥有演讲者模式、演讲者备注和丰富主题——无需安装 PPT 软件,打开浏览器即可演讲,是开发者制作高性能网页演示文稿的终极选择。
为什么选择 MDX Deck 而不是传统PPT?
传统 PPT 文件笨重、协作困难、无法嵌入交互内容,而 MDX Deck 把演示文稿变成了纯文本的网页应用,核心优势有 5 个:
| 特性 | 说明 |
|---|---|
| ✍️ Markdown 编写 | 用熟悉的 Markdown 语法写幻灯片,版本管理零压力 |
| ⚛️ React 组件 | 幻灯片内可直接嵌入 React 组件,实现图表、动画、可运行代码 |
| 🎨 可定制主题 | 内置十余套主题,任意样式都可定制 |
| ⚡ 零配置 CLI | 一条命令启动开发服务器,无需写配置 |
| 🎤 演讲者模式 | 自带下一张预览、计时器和演讲者备注 |
三步上手:创建你的第一份演示文稿
第 1 步:安装
在项目目录中安装 MDX Deck 作为开发依赖:
npm i -D mdx-deck
第 2 步:编写幻灯片文件
创建一个 .mdx 文件(可参考 examples/basic/deck.mdx),用 --- 分隔每一张幻灯片:
# Hello
---
## This is my deck
---
## The End
第 3 步:启动演示
在 package.json 中加入启动脚本,指向你的 .mdx 文件:
"scripts": {
"start": "mdx-deck deck.mdx"
}
运行 npm start,浏览器自动打开演示页面,用左右方向键即可翻页。就这么简单!
不止Markdown:在幻灯片中嵌入React组件
MDX 的精髓在于:Markdown 语法 + JSX 语法自由混排。你只需在 Markdown 内容之间用空行分隔,即可导入并使用任意 React 组件:
import { Box } from 'theme-ui'
<Box color="tomato">Hello</Box>
这意味着你的幻灯片不再是静态图片,而是可以包含实时数据图表、交互演示、可运行代码片段的活页面。
此外,MDX Deck 还提供了一组无需导入的内置组件(基于 MDX shortcodes),详见 docs/components.md:
<Notes>— 演讲者备注,仅在演讲者模式可见,支持 Markdown<Header>/<Footer>— 贯穿整个演示的页眉/页脚,适合放 Logo 和署名<Steps>— 让同一页的内容分步逐条出现,非常适合讲流程和代码逐行解析,参考 examples/steps/deck.mdx<Head>— 设置文档标题、社交分享卡片等 meta 信息
换肤一步到位:内置主题一览
MDX Deck 基于 Theme UI + Emotion 构建,几乎任何部分都可以主题化。主题源码位于 packages/themes/,内置 Dark、Comic、Book、Script 等十余套主题,完整清单见 docs/themes.md。
启用内置主题只需在 .mdx 文件顶部导出 theme:
import { themes } from 'mdx-deck'
export const theme = themes.dark
暗色主题(Dark)效果,简洁沉稳,适合技术分享:
而换成 Comic 主题,整份演示立刻变成手写漫画风:
想要完全自定义?只需导出一个包含 colors、fonts、styles 的对象即可,详细字段参考 docs/theming.md,自定义主题示例见 examples/themes/theme.js。
专业级演讲体验:演讲者模式与总览模式
演讲者模式:双屏同步演示
按下 Option + P 进入演讲者模式:左侧是你看到的主控窗口,包含下一张幻灯片预览、计时器和演讲者备注;点击底部链接在新标签页打开观众窗口,两个窗口自动保持同步。
完整演讲流程见 docs/presenting.md。
总览模式与键盘快捷键
演讲中按 Option + O 可进入总览模式,所有幻灯片以缩略图网格排列,点击任意一张即可跳转——就像 PPT 的幻灯片浏览视图,但完全基于网页:
常用快捷键一览:
| 按键 | 功能 |
|---|---|
左箭头 / Page Up |
上一张(或上一步 Step) |
右箭头 / 空格 / Page Down |
下一张(或下一步 Step) |
Option + P |
切换演讲者模式 |
Option + O |
切换总览模式 |
Option + G |
切换网格模式 |
导出与分享:静态页面、PDF、PNG
演示做完,分享方式同样灵活(见 docs/exporting.md):
- 静态构建:
mdx-deck build deck.mdx导出纯静态 HTML,丢到任意静态托管即可分享 - PDF 导出:配合
website-pdf工具一键生成,方便归档 - PNG 截图:单页或整份演示导出为图片,适合社交分享
写在最后
MDX Deck 用 Markdown 的简洁 + React 的强表达力,重新定义了网页演示文稿的玩法:写作像写文档,效果像做产品。无论你是要技术分享、课程讲义还是产品发布,都值得试试这套"文本即幻灯片"的完整方案。更多示例可浏览 examples/ 目录下的各场景演示文稿。



