用途：把 Markdown 文件转换为自包含的单 HTML 幻灯片，适合希望用版本控制管理讲稿、在没有演示软件或云账号的笔记本上放映、以及把文档改造成幻灯片的场景。
主要能力：支持 title、section、default、two-column、quote、image 六种版式；用 --- 分隔幻灯片，用 ??? 标记演讲者备注；内联主题与导航脚本，支持键盘、遥控器、哈希路由和明暗主题切换；提供密度检查器，按每页词数、要点数、每要点词数、标题字符数、表格行数、代码行数给出警告与错误阈值，并区分 present 与 read 两种密度预算；还能按实际语速生成计时流程表。
使用方式：先运行密度检查，再构建。示例命令： python3 markdown-html/md-slides/scripts/slide_density_linter.py --input markdown-html/md-slides/assets/sample_deck.md --profile present python3 markdown-html/md-slides/scripts/md_to_slides.py --input markdown-html/md-slides/assets/sample_deck.md --out build/deck.html --format text 计时可用 notes_runsheet.py，支持 --wpm 与 --target-minutes。脚本退出码约定为 0 正常、2 未过阈值、1 工具自身出错。
适用场景：现场演讲、按固定时长排练、把文档转成幻灯片初稿、生成含备注的讲义。
限制：构建前需确认是现场演讲还是传阅阅读、时长、图片是否必须内嵌、房间光线，否则密度预算可能选错；图片用相对路径时产物是文件夹而非单文件，邮件发送会失效；暗色主题在明亮环境下对比度不足；密度阈值只是代理规则，title、section、quote、image 版式不受正文规则约束。资料未提供收费、价格与平台支持信息。