Markdown 是内容源，不是首页导航

假设一份草稿只有“上下文很重要，参考前面的实验”两句话，并含有一张私人附件链接。作者自己知道实验背景，读者却不知道。改成课程时，应补齐问题、必要概念、可公开重现的例子、操作步骤和答案，并重新制作不依赖私人附件的图解。

可以把“前面的实验”改成完整的虚构案例：给模型同一任务，分别提供缺失资料和完整资料，比较输出中哪些部分能够核对。案例要说明它展示什么，也说明它不能证明所有模型在所有任务上的表现。这样读者无需拿到作者原始目录也能理解。

发布前做一次往返检查

先在正文源中核对标题层次和链接，再查看渲染页面，最后回到源文件检查修改是否准确保存。代码块应保持空格和换行；表格在窄屏应可读或独立滚动；图解需要文字替代与相邻解释；内部笔记链接应转换为公开页面链接或移除依赖。

图片存在于作者机器上，不代表发布服务能够读取。需要把允许公开的资源纳入交付产物，并检查实际页面返回。替代文字也不能只写“图片”，应说明图中表达的关系，让图未加载或使用辅助技术时仍能理解。

更新内容不等于重新创建课程

一次正文扩写通常只需要更新正文与配套资源。课程身份、章节关系、笔记和进度应保留。更新前可保存版本与变更清单，更新后核对预期课时数量、链接和页面内容，再保留回滚办法。即使不负责工程实现，作者也应该在交付清单中写明这些要求。