SuperAPI AI 工具集

md-slides

办公与效率

查看项目

更新于 10-16 04:59

技能介绍

用途:把 Markdown 文稿转换为单文件 HTML 演示幻灯片。输入需用 --- 分隔线或 # 一级标题划分页面,并可包含 <!-- notes: ... --> 演讲者备注块。当输入被路由为 SLIDES、用户直接运行 /cs:md-slides <path>.md,或出现 3 个以上 --- 分隔线 / 5 个以上一级标题且正文较短时触发。

主要能力:输出 HTML 中所有幻灯片为 <section class="slide">,一次只显示一页;支持键盘导航(→ / 空格 / PgDn 前进,← / PgUp 后退,Home/End 跳转,P 进入演讲者模式,Esc 退出);URL 哈希深链接(如 #3 跳到第 3 页,可分享 deck.html#5);顶部 3px 进度条;右下角页码计数;演讲者模式分屏显示时钟、备注与下一页预览;打印样式表支持 Cmd+P 一页一幻灯片导出 PDF;遵循 prefers-reduced-motion。设计系统提供 12 个品牌 CSS 自定义属性,design_style 影响布局密度,并复用 md-document 的 Markdown 解析器保证段落、列表、代码、表格、标注渲染一致。

使用方式(三步管道): python3 markdown-html/skills/md-slides/scripts/slide_splitter.py --input <path>.md --output /tmp/slides.json python3 markdown-html/skills/md-slides/scripts/presenter_notes_parser.py --slides /tmp/slides.json --output /tmp/deck.json python3 markdown-html/skills/md-slides/scripts/deck_html_renderer.py --slides /tmp/deck.json --title "My Talk" --output deck.html 默认输出为 {default_output_dir}/deck-{slug}.html,冲突时追加 -2、-3 等后缀。

限制:无明确分页边界时拒绝处理(自动模式需 ≥3 条 --- 或 ≥5 个一级标题,否则退出码 6);只生成 1 页时拒绝(退出码 5);输入少于 100 行拒绝;未完成 onboarding 拒绝;--strict-notes 下备注覆盖率低于 50% 拒绝(退出码 7);单页超过 40 行源文本会软警告。输出为单文件,CSS 与 JS 内联,仅外部引用 Google Fonts CSS,Prism.js 需通过 --syntax 开启;不使用 React/Vue/Svelte 等框架运行时。与 md-document(连续文档)、md-review(差异审阅)、落地页及 Keynote/PowerPoint 等图形设计工具定位不同。