Marp skill 第一次跑空白先查什么：先查入口、示例和预览信号（skill首测版）

你打开 Marp 时，最该先解决的是“先让本地预览亮起来”。很多新手卡住，不是因为工具难，而是第一步就把清单、模板、生成器和导出器混在一起，结果下载了文件、装了依赖，却不知道该看哪个结果。

范围只收窄到三个问题：先让本地预览亮起来、导出前固定主题和图片路径、只用三页小稿排错。如果你的目标正好是 Markdown 演示文稿生态入口，适合把文档快速转成可演示页面、PDF 或 PPTX，它值得试；如果你需要的是完全自动、可直接商用且不用再检查授权的成品，就要把预期降下来。

先判断：先让本地预览亮起来

Marp 对应的对象是Markdown 演示工具，主要交付 Markdown deck、HTML、PDF、PPTX 或图片型导出。这一步不要急着问功能全不全，先问结果能不能落到你的任务里：是文件、网页、模板、候选链接，还是一套需要宿主识别的 Skill。

一个实用判断是，先写一句小目标，例如“用 Marp 跑出一个能打开的小样”。这句话能把正式汇报、复杂模板、远程图片和多格式导出先挡在外面，失败时只查入口、依赖和输出三处。

第二步处理：导出前固定主题和图片路径

可用 VS Code 扩展或 Marp CLI；命令行路线先安装 @marp-team/marp-cli。 依赖重点放在 Node.js、包管理器、浏览器预览和中文字体；导出 PDF/PPTX 时再看 Playwright 或浏览器环境。

npm install -g @marp-team/marp-cli
marp slides.md --pdf

如果这里出现命令不存在、README 路径对不上、页面空白、字体丢失或权限报错，先不要加新功能。把环境收窄到一个目录、一个示例、一种输出；看到 导出的 PDF/PPTX 版式稳定，图片路径和主题文件都能被解析，才算这一步过关。

收尾前看：只用三页小稿排错

首测内容只用小稿：写三页 Markdown，包含标题、列表和图片，先导出 PDF。清单类项目只选一个候选入口；模板类项目只替换封面、目录和图表页；Markdown 演示工具只保留封面、列表和图片三页；Agent Skill 只让它生成最小可打开结果。

不适合继续投入的信号也要写清：复杂交互动效不是它的强项；需要 Vue 组件或代码直播时可看 Slidev。如果授权、输出格式、可编辑性或团队运行环境对不上，宁可停在小样阶段，也不要把正式材料压进去返工。

把 Marp 用稳，靠的是先抓住这几个痛点，而不是把所有能力一起试完。入口能对上、最小样能打开、成功信号能复现，再把真实模板、图片、导出格式或长材料逐个加进去，风险会小很多。