告别PPT!MDX Deck完全入门:用Markdown+React快速打造高性能网页演示文稿

原创2026-09-21 21:12:291,616 阅读
文章标签:开发工具前端

告别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)效果,简洁沉稳,适合技术分享:

MDX Deck暗色主题演示文稿截图

而换成 Comic 主题,整份演示立刻变成手写漫画风:

MDX Deck漫画主题演示文稿截图

想要完全自定义?只需导出一个包含 colors、fonts、styles 的对象即可,详细字段参考 docs/theming.md,自定义主题示例见 examples/themes/theme.js。

专业级演讲体验:演讲者模式与总览模式

演讲者模式:双屏同步演示

按下 Option + P 进入演讲者模式:左侧是你看到的主控窗口,包含下一张幻灯片预览、计时器和演讲者备注;点击底部链接在新标签页打开观众窗口,两个窗口自动保持同步。

MDX Deck演讲者模式演示文稿截图

完整演讲流程见 docs/presenting.md。

总览模式与键盘快捷键

演讲中按 Option + O 可进入总览模式,所有幻灯片以缩略图网格排列,点击任意一张即可跳转——就像 PPT 的幻灯片浏览视图,但完全基于网页:

MDX Deck总览模式幻灯片网格截图

常用快捷键一览:

按键 功能
左箭头 / 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/ 目录下的各场景演示文稿。

登录后查看全文
mdx-deck