ARTICLE / 开源项目

Mindmap PPT

Open Source Custom Edition

把文章、报告、演讲稿或笔记变成可逐步播放、检索、分享和离线交付的思维导图演示。内容保持为易维护的文本结构，页面使用静态 HTML、CSS 和 JavaScript，可直接本地运行或部署到 GitHub Pages。

内容输入：文章、会议纪要、课程笔记、产品文档、演讲提纲

演示输出：网页播放、节点深链、离线 ZIP、打印与 PDF

操作方式：键盘、鼠标滚轮、触摸板、移动端滑动

项目亮点

按思维导图的层级逐节点播放，支持方向键、Page Up / Page Down、Space、Home 和 End。当前节点、进度滑条、大纲与 URL 始终同步。

滚轮上下移动视角，Shift + 滚轮横向移动，触摸板双指自由平移，Ctrl + 滚轮或 Mac 捏合手势以指针为中心缩放。

大纲保留完整层级和访问状态，可搜索标题或内容。节点可配置稳定 ID，分享链接在改文案或调整结构后仍能定位。

支持生成可运行的离线目录和 ZIP，导出过程检查缺失素材与路径安全；也可按根概览和一级分支打印为横向 PDF。

提供全屏演示、页面内沉浸模式、黑屏、自动隐藏控件和减少动态效果适配，适合正式讲解与会议投屏。

内容和图片保存在项目目录，静态运行无需后端服务。缩放、控制面板和大纲偏好保存在浏览器本机。

git clone https://github.com/x7peeps/mindmap-ppt-custom.git
cd mindmap-ppt-custom
npm install
npm run dev

默认访问 http://127.0.0.1:5173/。编辑 project/source.js 即可替换演示内容，本地插图放在 project/ 下。

常用检查与交付命令：

npm run check
npm run check:browser
npm run export

仓库内附带 mindmap-ppt-builder Skill，可帮助 Agent 把文章、报告或笔记整理为结构清晰的演示导图：

npx skills add x7peeps/mindmap-ppt-custom --skill mindmap-ppt-builder

本仓库是基于 agegr/mindmap-ppt 的二次开发版本。

感谢原作者 Alex Yang（agegr）创建并公开原始项目。二开仓库保留了原始 Git 提交历史和作者记录，并在 README 与 NOTICE.md 中持续标注来源。

截至本页面发布时，上游仓库未包含许可证文件，GitHub 也未识别到开源许可证。公开可见不等于自动授予复制、再分发或商业使用权；有相关使用需求时，请查阅上游最新状态并向原作者取得必要许可。