关于本书

在线版 ｜ PDF ｜ GitHub

大约 6 年前，我偶然发现了 Marp。从那以后，我几乎没有再碰过 PowerPoint。

用 Marp 是「写」幻灯片 (只需专注于内容即可)；
而用 PowerPoint 则是「做」幻灯片 (需要花大量的时间调整格式)。

 

随着 AI 的普及，Marp 的优势更加明显：你只需几句简单的提示词就可以把 PDF，Word，Markdown 等文档的内容转换成 Marp 幻灯片。由于 Marp 是采用 Markdown 标记语言来写的，所以无需任何格式方面的设定，直接将 AI 输出文本贴入 VS Code 的 Markdown 编辑器即可渲染为幻灯片。

你能学到什么？

这本书不是 Marp 技术手册。我不会把所有参数都列出来，也不会讲 CSS 主题开发的原理。相比于连享会此前发布的偏技术性的 推文，本书的目标在于：让你尽快上手 Marp，并协助 AI 提示词实现你想要的各种效果。

具体来说，读完这本书，你应该能够：

  • 在 VS Code 里从零做出一份 Marp 幻灯片  第 1 章
  • 掌握最常用的几个设定  第 2 章
  • 知道怎么插图、排版代码、写数学公式  第 3 章 和 第 4 章
  • 学会如何借助 AI 工具继续扩展和优化  第 5 章

最终，你会乐于使用 Marp 制作幻灯片。

怎么用这本书？

如果你完全没用过 Marp，请从 第 1 章 开始读，跟着操作一遍。大概 10 分钟，你就能看到自己做出的第一份幻灯片。

如果你已经会基本操作，想解决某个具体问题，可以直接跳到 附录，或者在左上角的搜索框中检索关键词。

这本书是怎么写的？

这本书是借助 Claude code 生成的，耗时约 10 小时。虽然整体上不错，但难免错漏。欢迎大家提出修改意见和建议。

你可以点击本书 GitHub 仓库 上方的 Fork 按钮，将本仓库复制到你的 GitHub 账号下，然后在你的仓库中进行修改和编辑，最后通过 Pull Request 向我提交修改建议。当然，你也可以发邮件给我：。

发布自己的在线讲义

你也可以修改本仓库的内容，形成符合你个人风格要求的书稿。具体步骤如下 (详情参见：连玉君，2025，Quarto Book)：

  • Fork 在 GitHub 上 Fork 本仓库。
  • Clone 在本地使用 Github Desktop (教程) 或者 Git 命令将 Fork 后的仓库 clone 到本地，然后在 VS Code 编辑器中修改内容。
  • Render  在 VScode 终端执行 quarto render 命令生成新的网页内容。在此之前，你需要安装 Quarto，以及 VScode 的 Quarto 扩展。
  • Push 使用 GitHub Desktop 或 git 命令将修改后的内容 push 到 GitHub 上。
  • Publish 在 GitHub 上打开你的仓库，点击 Settings → Pages，在 Source 处选择 main branch - docs，然后点击 Save。
  • 稍等几分钟后，你的在线讲义就会发布成功，网址为 https://你的用户名.github.io/marp-book/。

 

好了，我们开始吧。🎉

    主页 | 课程 | 视频 | 推文 | 资料