Elysia Tools

导航

Workflow Playbook

Markdown 互动课件审校、离线演示与交付

审校一份互动 Markdown 课件，核对正文与配置变更，验证实际离线播放器，并分开交付观众文件与私密演讲源稿。

从这里开始

第一次接触这个流程？按步骤顺序来，从下面第一个工具开始。已经知道自己需要什么？直接跳到对应的步骤——本流程用到的全部工具都在下面的对比表里。

第一个工具: Markdown 规范与风格检查器

专题

本流程用到的工具对比

工具	用来做什么	分类
Markdown 规范与风格检查器	按约 15 条 markdownlint 规则加 2 条中文排版规则检查 Markdown，给出带行号的问题清单，并可一键自动修复安全项	Text Processing
Markdown 链接检查器	静态检查 Markdown 链接的格式错误、悬空锚点和未定义引用（不发起网络请求）	Development
幻灯片工作室	把 Markdown 变成交互演示文稿。本地编辑、离线播放，也可发布不公开列出的快照。	Document Tools
文本对比	比较两个文本输入并显示差异	Text Processing
JSON 差异可视化	比较两个 JSON 并生成带颜色、路径和统计信息的可视化差异报告	Development
颜色对比度检查器

专题

继续浏览相邻主题专题

先确定一堂课与它的观众

本流程面向讲师、培训人员与技术分享者，目标是一份可以讲授的互动课件，不是通用文章，也不代替学习管理平台。记录学习结果、已批准的事实、讲者和预计时长。区分观众包与私密工作源稿；会发送到服务端的辅助检查不得包含学员身份、密钥或机密案例。

审校时保留课件语法

保存基线 Markdown 和 JSON。工作室使用标题、分页符、演讲备注标记及展开、测验指令；通用检查可能把重复标题当错误，或修改有意义的空白。只在副本上检查，解释每项发现，将接受的修改放回工作室验证，不对整份课件盲目自动修复。

链接检查是静态的：语法、引用和锚点通过不代表 HTTP 目标可达。另行打开必要链接，并在实际课件检查锚点。需要联网的目标准备备用方案，链接写进离线课件并不会把目标网站一起带到离线环境。

核对内容、配置与视觉问题

文本差异用于正文，JSON 差异用于页序、布局、主题、过渡和交互配置。比较稳定版本，说明重新生成的标识，不能把所有字段变化都当成内容变更。人工核对测验选项及正确答案是否符合学习目标；结构合法不代表知识正确。

检查所选主题的真实文字及背景色对，按适用范围用脱敏渲染 HTML 查常见标签和结构问题。静态工具不会执行展开序列，也不能认证焦点或整体可访问性。人工排练键盘、可见焦点、结果反馈、交互状态对比度和小屏可读性，记录未解决项，不宣称通过认证。

排练导出文件，不只看编辑器

导出 HTML，在目标浏览器打开同一个文件，然后断网逐页测试导航、展开与测验。检查长文本、代码块、翻页边界和必要媒体，登记浏览器、版本及缺失资源。播放器代码被打包，不代表每个外链或外部素材都能离线；必要内容失败时修复或明确缩小交付承诺。

观众播放器代码会移除备注，但源文件导出仍可能保留。检查 HTML 与实际观众视图，再单独检查 Markdown/JSON。不能因为预览隐藏备注，就把带备注源稿直接交给观众。80 页及每份 2 MB 是工作室边界，超过时应明确精简，不静默漏页。

分开交付私密源稿和分享文件

最后修改后为文件计算哈希。受控讲者包保存可编辑源稿，观众包单独提供审阅过的 HTML，附版本、变更台账、排练证据、已知限制和复核人。哈希只能标识文件，不证明教学准确。

发布是可选附加步骤：登录发布快照后检查实际观众网址和无备注内容。非公开索引不等于保密访问；编辑源稿也不能证明已有快照已更新，须核对发布版本。通用 Markdown 发布、技术文档本地化及网页可访问性专题用于各自更广的任务，不能代替这份互动课件的实际排练。

开始前准备

确定受众、学习目标、讲者、已批准事实及简短排练清单，使用获授权的文字和素材，不包含学员隐私。

保留基线 Markdown/JSON；工作室最多支持 80 页和每份 2 MB，普通 Markdown 工具不能理解全部课件指令。

编辑本地运行，但发布及辅助工具可能向服务端发送内容；检查输入不含私密备注，并在上传前确认分享权限。

选择正确路径

修复格式还是保留课件语法？

重复标题、分页、备注及交互围栏需按课件规则复核，通用格式修复只在副本上操作并回到工作室确认。

离线文件还是非公开索引快照？

导出 HTML 用于断网排练；发布要求登录，但观众链接不等于访问控制，只发布允许分享的内容。

静态检查还是交互验收？

对比度和 HTML 检查用于定位问题；键盘、展开顺序、测验、移动布局与断网行为必须实际排练。

完成标准

页序、陈述、链接、展开内容和测验答案与批准稿一致，有意变更有说明。

讲者备注留在受控源文件包，实际观众 HTML 和可选发布快照均检查过意外泄露。

断网后打开实际导出的 HTML，导航、展开、测验和必要内容可用，缺失依赖明确列为阻断项。

最终 Markdown/JSON 与观众文件有哈希、版本、排练证据、复核人和明确发布范围。

Markdown 互动课件审校、离线演示与交付

从这里开始

本流程用到的工具对比

继续浏览相邻主题专题

先确定一堂课与它的观众

审校时保留课件语法

核对内容、配置与视觉问题

排练导出文件，不只看编辑器

分开交付私密源稿和分享文件

开始前准备

交付可以实际讲授的课件，明确观众与讲者材料边界

审校结构与引用

制作并核对课件

检查可读性与结构

排练实际观众文件

标识版本并交接

选择正确路径

修复格式还是保留课件语法？

离线文件还是非公开索引快照？

静态检查还是交互验收？

完成标准

文档编写、审阅与发布

Markdown 技术文档翻译审校与交付

网页发布前无障碍审查

Markdown 规范与风格检查器

Markdown 链接检查器

幻灯片工作室

文本对比

JSON 差异可视化

颜色对比度检查器

无障碍合规检测器

幻灯片工作室

文件哈希校验器