Xiaoma Ppt — Documentation skill for Claude Code

xiaoma-ppt

把文档（Markdown、Word、txt、PDF……）套进你自己的 PPT 模板，生成「像模板本来就长这样」的可编辑 .pptx。任何能写代码的模型 / agent 都能用。 Turn Markdown / Word / plain text into an editable .pptx that looks native to *your* corporate template — usable by any coding model or agent.

商用 PPT 的难点不是好看，是**和模板一致**：公司模板的颜色、字体、页眉页脚、logo、背景一样都不能动，内容还得排进模板留出来的地方。现有的 AI 做 PPT 工具大多是「换一套它自己的主题」，生成的东西拿到公司里没法用。

xiaoma-ppt 反过来：**版式从模板里找，颜色字体从模板里取，内容只在模板留出的地方画。**

例子

5 套行业模板（虚构品牌，代码生成，见 [`tools/make_templates.py`](tools/make_templates.py)）× 5 份行业 md。每张图上排是模板原页，下排是生成结果。

**金融 · 睿信资本《2026 年三季度财富管理业务复盘》** —— 海军蓝 + 金色，衬线标题，直角；装饰做在版式里 

**医疗 · 康宁医疗《社区慢病管理数字化项目年度汇报》** —— 白 + 青绿，圆角；标题是占位符，目录条目是组合 

**教育 · 启明教育《结构化面试官培训》** —— 奶油底 + 暖橙，大圆角、点阵装饰 

**制造 · 华铸智造《精益数字化工厂建设汇报》** —— 石墨 + 安全橙，蓝图网格；内容页标题压在深色页眉带上 

**文旅 · 云栖文旅《云栖四季 · 2027 文旅推介》** —— 宣纸 + 水墨远山 + 青绿朱砂；内容页右下角有山，内容自动避开 

复杂模板

上面 5 套模板每套只有 5–6 页、结构干净。真实企业模板要乱得多，下面 3 套照着真实模板的复杂情况做（同样是虚构品牌、代码生成，见 [`tools/complex_*.py`](tools)），内容分别用 Word、Markdown、txt 给出。

**能源央企年度汇报 · 岳川能源**（13 页模板 + Word 内容）——全部用母版、版式和占位符搭成，页面上的标题占位符是空的；颜色字体全走主题引用；10 × 5.625 英寸的老尺寸；母版右下角有曲线装饰；内容页左侧有章节导航条（当前章节垫主题色）；深色页靠页面级配色映射反色；自带表格、图表、KPI 卡片、时间线等示例页 

**科技发布会 · 星曜科技**（13 页模板 + Markdown 内容）——Keynote 导出式结构，所有东西都在页面上、没有占位符；全幅星空大图、渐变文字、描边空心数字、半透明玻璃卡片、竖排「目录」、旋转 90° 的英文；内容页右侧有出血的手机样机；有「左侧标题面板、右侧放内容」的页；自带金句页 

**咨询研究报告 · 衡策咨询**（14 页模板 + GBK 编码的 txt 内容）——第一页是隐藏的「模板使用说明」；议程写在一个文本框里；章节页是「高亮当前议题的议程页」；内容页右上角有进度标签、底部有资料来源和页码；带 2×2 矩阵、瀑布图、哈维球表、甘特图、组织架构、箭头流程等示例页；有带右侧要点栏的版式；封底是免责声明 

这些模板拆出来的问题都修进了引擎：

• 页面角色：隐藏页跳过，第一张没隐藏的页才是封面；免责声明封底认成结尾；模板自带的金句页直接拿来放引用；议程式章节页、左标题内容页都认得出。
• 导航：进度标签 / 章节导航条每页写上章节名，当前章用模板的高亮样子，高亮标记跟着移；段落式议程沿用模板的编号格式。
• 槽位：页码、页脚占位符不当槽位；位置继承自版式的占位符能正确调整；封面上的英文眉题（ANNUAL REPORT）不被当成副标题，章节页上的 CHAPTER ONE 跟着章节号变。
• 颜色和版面：主色不被渐变遮罩带偏；背景上的柔光不当成插画避开；带侧