Marp

简介

Marp 是一个专门用来把 Markdown 文档转为幻灯片的工具，支持导出为 PDF、HTML、PPTX 等格式

对比

pandoc 是通用的格式转换工具，也能将 markdown 转为 pptx 格式。而 Marp 更专注于幻灯片这种展示形式，并对此做出了一些优化

• 内置了多个幻灯片主题
• 即使导出为 PDF/HTML 也仍然使用幻灯片的样式和排版风格
• 提供了 VSCode 扩展，能够实时预览，显著改善编辑体验

因此针对该特定需求可能 Marp 用起来更方便、效果更好

安装

# Windows
scoop install marp

下载 VSCode 扩展 Marp for VS Code

配置

Marp 支持自定义主题。如果不太熟悉 CSS，可以去社区下载别人分享的主题。在 GitHub 上搜索 marp theme 就能找到许多主题。

我目前使用 Awesome Marp 这个主题。首先到 仓库 中下载 am_template.scss 和 am_dark.scss 这两个文件，然后修改工作区的 .vscode/settings.json 文件

{
  "markdown.marp.themes": [
    "./themes/marp/am_dark.scss",
    "./themes/marp/am_template.scss"
  ]
}

使用

# HTML
marp example.md
# PPTX
marp example.md --pptx
# PDF
marp example.md --pdf