md2pptx：免费开源的 Markdown 转 PPT 工具，如何一键快速生成演示文稿

md2pptx：免费开源的 Markdown 转 PPT 工具，如何一键快速生成演示文稿

【免费下载链接】md2pptxMarkdown To PowerPoint converter项目地址: https://gitcode.com/gh_mirrors/md/md2pptx

md2pptx 是一款免费开源的 Markdown 转 PPT 工具，把一份 Markdown 文本渲染成带版式、图表和表格的 PowerPoint 文件，适合做技术分享、维护文档的工程师和讲师。

会议前的两个小时

周三上午十点有架构评审，你的 Markdown 文档昨晚刚改完。如果按老办法做 PPT，接下来两个小时的流程是：逐段复制、调字号、换配色、对齐文本框；改一处内容，还要回文档里重新核对原文。内容本身没有工作量，工作量全花在格式上。

md2pptx 把这件事反过来：Markdown 负责内容，PowerPoint 只负责呈现，中间一条命令完成。

效果先看

先看几张实际转换出来的幻灯片。

版式类：卡片、漏斗、清单。

多张并列卡片适合展示并列的功能或特性，对齐和间距由工具统一处理。

漏斗图用几行配置就能画出来，适合讲流程和转化。

任务清单自带完成状态图标，项目进度一目了然。

图表与数据类：

在文档里嵌入一小段 Python 代码，就能生成这张柱状图幻灯片。

表格直接从数据生成，列宽和样式保持一致。

md2pptx 安装与首次转换

环境要求是 Python 3.11 及以上，外加一个依赖库 python-pptx：

git clone https://gitcode.com/gh_mirrors/md/md2pptx cd md2pptx && pip3 install python-pptx && chmod +x md2pptx

转换时程序从标准输入读取 Markdown，第一个参数是输出文件名：

./md2pptx 演示.pptx < 文稿.md

建议在文稿开头、第一个空行之前加一行元数据template: Martin Template.pptx，指定样式模板。标题页、章节页、列表页的样式都来自它。生成的 pptx 是标准文件，可以直接在 PowerPoint 里继续编辑。

把样式变成自己的

模板决定整套幻灯片的字体、配色和占位符。用 PowerPoint 打开 Martin Template.pptx，通过"视图→幻灯片母版"改掉字体和主题色，保存即可。之后每次转换自动套用新样式，不用改任何代码。

批量生成 PPT 也不用写专门脚本：把上面的转换命令放进一个循环，遍历目录里的 .md 文件，几十个文件几分钟跑完。

需要更强表达时，仓库自带几个模块：card.py画信息卡片，funnel.py画漏斗图，runPython.py允许在幻灯片中间执行 Python 生成图表。完整语法见 使用文档，示例目录 里有几个可直接参考的成品文稿。

时间上，同一份 10 页左右的分享材料，手工排版通常要一个半小时上下；用 md2pptx 写完内容后，转换本身只要一分钟。

适合谁，以及容易踩的坑

比较适合的场景：

• 技术文档工程师：文档更新后同步出演示稿
• 软件开发：技术分享 PPT 快速制作，评审和演示前临时赶稿
• 培训讲师：课件与讲义共用同一份内容源
• 项目经理：进度汇报直接用任务清单页

常见的坑：

• 模板字体不支持中文时会显示方框，换一套中文字体再保存模板
• 图片路径是相对 Markdown 文件的位置解析的，移动目录后要检查相对路径
• 代码块必须用三个反引号包住，否则按普通文本排版
• python-pptx 目前要求 Python 3.11 以上，老版本环境会直接报错
• 幻灯片内容和演讲者备注之间要留一个空行，否则备注会并进正文

写在最后

md2pptx 把 Markdown 转 PPT 这件重复劳动压成了一条命令，内容改完就能重新生成一版。

下一篇技术分享开始，试试让文稿和 PPT 只维护一份。

【免费下载链接】md2pptxMarkdown To PowerPoint converter项目地址: https://gitcode.com/gh_mirrors/md/md2pptx