Markdown 幻灯片 HTML 转换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/md-slides。
技能介绍
问题在哪
很多演示稿其实是用 Markdown 写的:用 --- 或一级标题切页,偶尔在备注里写讲稿。真正上台或发给别人时,却还要再进 Keynote、reveal.js 或 Marp 里套一遍模板、拷依赖、对齐导出路径。你更需要的是一份能在任意浏览器打开的 HTML,键盘能翻页、能开演讲者视图、能 Cmd+P 打成一页一版的 PDF,而且最好只有一个文件,方便邮件或内网传。
技能如何工作
md-slides 走一条纯标准库工具链(与编排器里的 markdown-html 流程衔接):读取 Markdown deck,按分页边界拆成多张幻灯片,输出 {default_output_dir}/deck-{slug}.html。单文件内联 CSS 与 JS,不挂 React/Vue 运行时;可选 --syntax 才拉 Prism。
生成物里常见能力包括:
- 翻页:
→/ 空格 /PgDn下一页,←/PgUp上一页,Home/End跳转;顶部细进度条与右下角页码 - 深链:
deck.html#3直达第 3 页,浏览器前进后退按页走 - 演讲者模式(
P):左侧当前页,右侧时钟、备注与下一页预览;Esc退出 - 排版:复用
md-document的 Markdown 解析,正文段落、列表、代码块、表格、callout 与文档站一致;支持设计系统的 CSS 变量与prefers-reduced-motion - 打印:专用打印样式,一页一幻灯片导出 PDF
编排侧若把输入标成 SLIDES、用户直接跑 /cs:md-slides,或稿子里有 ≥3 条 --- / ≥5 个短正文 H1,会路由到本技能。
边界与注意
没有清晰分页边界的稿子应走 md-document;只有一页的会被拒绝(那是海报不是 deck)。单页源码超过约 40 行仍会渲染,但会提示你考虑拆页。长文规格、代码 review diff 分别应走 md-document / md-review,不要硬当幻灯片。与落地页、Keynote 类图形工具不同,这里面向Markdown 写稿、浏览器投影的工作流。
使用场景
- 技术内部分享前,把用 `---` 或一级标题切好页的 Markdown 讲稿转成单文件 HTML,在会场用浏览器全屏投影并用键盘翻页。
- 讲稿源文件里写了演讲者备注,需要上台时按 `P` 打开分屏:左侧当前页、右侧时钟与下一页预览。
- 要把 deck 发给同事离线查看,生成仅内联 CSS/JS 的 `deck.html`,并通过 `#5` 让对方直接打开第 5 页。
- 幻灯片已在 Markdown 定稿,不想进 Keynote 排版,用浏览器打印样式一页一版导出 PDF 讲义或存档。
适合人员
- 习惯用 `---` 写多页演提纲、在浏览器里投影而非维护 reveal 构建链的工程师或 SRE
- 按一级标题拆页写培训大纲、讲台需要键盘翻页与演讲者备注面板的内部讲师
- 在 SkillHub/md 工具链里区分 SLIDES 与长文,要把明确多页 deck 落成可分发 HTML 的技术写作者
- 布道或 meetup 讲者:稿子在 Markdown,诉求是深链分享某一页且单文件便于邮件或网盘传递