纯文本给内容留一条退路
Markdown 用简单标记表达标题、列表和链接，便于在工具之间移动。优势不是所有编辑器显示完全一致，而是离开原应用后正文仍可读。优先保持清晰结构，不为编辑器特有的效果过度绑定内容。
文章往往不只有一个文件
图片、附件和引用也是内容的一部分。迁移前检查它们是本地文件、公开地址，还是需要原应用登录的私有资源。导出正文却丢失图片，不算完整带走文章；公开时还要核对图片里的隐私信息。
本机草稿不是跨设备同步
浏览器写作台可能只保存当前设备的数据。换浏览器、清理站点数据或设备损坏，都可能让未导出的草稿无法取得。重要草稿定期导出，进入自己的备份流程；导出后抽查内容，不只看下载提示。
草稿与线上版本分别管理
导出、保存、提交代码和发布是不同动作。记录当前公开版本的内容，避免读者看到尚未整理好的片段。工具可以更换，但正文与修改记录不必每次重建。迁移新工具前先用一篇样本走通导出与读取。
先定义一次小规模迁移
本篇任务是让一篇含图片和引用的文章离开原编辑器后仍能完整阅读，并能继续发布。准备正文导出、附件、来源链接和一份原渲染视图作为对照。先选一篇普通文章与一篇包含特殊语法的文章作为样本，不要直接搬整个文库。迁移成功应同时满足文字完整、附件可用、结构清晰和修改仍可保存，不能只看文件下载完成。
区分标准 Markdown 语法与编辑器扩展。CommonMark 定义常见标记解析，GitHub 文档说明表格和代码块等写法，但不同应用可能支持不同扩展。双链、嵌入卡片、专用图表、脚注或前置元数据都需逐项核对，不能因为扩展名一样就保证视觉一致。本文提供跨工具检查方案，示例文件与输出未在真实编辑器实测，也没有导出任何私有笔记。
# 目录计划，不代表文件已经存在
article-package/
article.md
assets/
request-flow.png
migration-record.md
正文与附件一起复制；图片需提供自己的授权文件。
引用相对于article.md：./assets/request-flow.png
共享附件另列引用关系，不跟随单篇随意删除。完整可填模板，示意且未实机验证；保存会写文件。请用自己的观察替换待填项，不把示意结果当实测。
建立正文与附件的可移动目录
给文章安排稳定目录，正文使用相对附件路径，附件名称表达内容而非依赖导出器生成的临时编号。移动时以整个文章目录为单位，避免只复制一个 Markdown 文件。若多个文章共用附件，则记录共享目录位置和引用关系，不能随其中一篇归档就删除共享图片。远程图片还依赖原地址的可达性与权限，离开原登录会话可能立即失效。
在正文里写替代文本，使图片缺失时仍能理解它的用途。图片本身保存为常规格式并抽查尺寸和方向；编辑器里的裁剪、标注或专用白板可能需要单独导出可读副本。附件目录不是权限系统，公开发布前按允许公开的文件清单选择内容。macOS 常见文件系统可能容忍大小写差异，GNU/Linux 托管通常更严格，应让引用与文件名精确一致；DSM 文件共享也应按实际路径核对，不凭桌面预览猜测。
用可读结构替换专用效果
正文标题层级要表达文章结构，列表要表达并列或步骤，代码块标明语言但不依赖高亮才能看懂。表格若在目标工具不支持，可以转换为小标题与字段列表，避免丢失信息。复杂布局可以保留截图作为外观参考，但正文仍需要普通文本说明；只有截图的笔记无法方便检索和修订。转换应保留意义优先，视觉差异单独记录。
对原工具的内部链接，先确认导出后是否成为正常相对链接或稳定网页地址。无法解析的双链应建立映射表，再逐篇替换，不以全局字符串替换猜测每个目标。前置元数据如标题、日期和标签不是所有渲染器都会解释，必要时同时写入正文或配套索引。发布日期保留原值，迁移或修订日期另记，不能让一次导出把所有文章伪装成新发布。
# 请求链路记录
本文是迁移样例，未实机验证。
## 任务
让一篇含附件的文章离开原编辑器仍可读。
## 检查步骤
1. 阅读正文并核对标题。
2. 打开下方图片，确认附件可达。
3. 核对代码与引用。
## 代码示例
```js
const healthPath = '/api/health'
console.log(healthPath) // 只显示路径，不发送请求
```
## 来源
[CommonMark 规范](https://spec.commonmark.org/0.31.2/)
## 验收
- [ ] 正文完整
- [ ] 图片可打开
- [ ] 代码保留原字符
- [ ] 引用可点击
若目标工具不支持任务列表，把以上项目作为普通列表填写结果。完整可填模板，示意且未实机验证；保存会写文件。请用自己的观察替换待填项，不把示意结果当实测。
完整案例：一篇含图文章的搬家
构造样本是 article.md 引用 assets/request-flow.png，并在末尾链接官方资料。先把二者放进同一文章文件夹，在普通编辑器读取正文，确认代码围栏闭合、标题顺序和链接目标没有被导出器截断。随后在另一种渲染环境打开，逐项比对标题、列表、图片、代码与引用。这里的预期结果是检查标准，本文没有生成或渲染真实样本。
假设新工具里图片不显示，先看相对路径是否以正文位置为基准，文件名大小写是否一致，是否仍指向原应用的私有附件地址。若是路径问题，只修正引用或移动整个目录中的附件，保留原导出包作对照；若原链接需要登录，则通过原应用的正规导出取得可迁移附件。修正后重新打开正文与附件，不能只在原工具确认。再模拟把整个文章目录移到另一个受控位置，验证没有依赖原绝对路径。
用双向修改检查可继续维护
迁移不只是展示旧文章，还要能继续编辑。选一段无敏感内容，修改文字后保存，再在另一工具打开，确认编码、换行和围栏没有被意外重写。比较差异时如果整篇都变化，先检查换行或格式化设置，避免把大量无意义变化混进实际修订。不要为了统一格式一次重排整个文库，先确定新的保存策略适合长期使用。
浏览器本地草稿尤其要单独处理。它可能只在当前站点、当前浏览器存储中，换设备或清理站点数据之前先完成导出并抽查。导出文件存在不等于附件已经包含，也不等于公开站点已更新；本地草稿、已导出稿和已发布稿分别记录版本。若工具只能输出部分内容，在验收表写明缺项并保留原环境，不能为了完成迁移表格提前删除唯一可读副本。
# 迁移记录
原工具/版本：<待填>
目标工具/版本：<待填>
原稿保留位置：<待填>
样本路径：<待填>
| 项目 | 原视图 | 新视图 | 处理 |
| --- | --- | --- | --- |
| 标题层级 | 待核对 | 待核对 | 待填 |
| 图片与替代文本 | 待核对 | 待核对 | 待填 |
| 围栏代码 | 待核对 | 待核对 | 待填 |
| 内链/外链 | 待核对 | 待核对 | 待填 |
| 专用扩展 | 待核对 | 待核对 | 替换/保留说明 |
复制到另一目录后的阅读：<待测>
修改后跨工具再打开：<待测>
损失内容与未验证项：<待填>
是否允许清理旧库：<尚不允许/验收后按保留策略处理>完整可填模板，示意且未实机验证；保存会写文件。请用自己的观察替换待填项，不把示意结果当实测。
收尾：建立导出和恢复的固定动作
完成两篇样本后，再按相同结构迁移其余文章，保留失败条目列表供逐项处理。最终检查文件数量只是辅助，还要抽查实际内容及代表性附件。可以保存简单清单记录每篇正文、附件和外链状态，未来更换工具时复用。不要把工具的同步成功提示当作独立备份，恢复验证应能离开原工具完成阅读。
回退时恢复原导出包或原稿版本，保留新工具里有价值的修改再合并，避免用整目录覆盖丢掉后续编辑。删除旧库属于 danger，只有确认正文、附件、链接和后续保存都完成验证后再按保留策略处理。这里的模板写入属于 write，阅读和对照属于 read。最终交付是一份普通工具能打开的文章目录以及已填的迁移记录，未验证的扩展语法明确列出，不声称所有 Markdown 编辑器完全兼容。
填写工作表，把示例变成自己的记录
目录模板中的图片只是路径占位，需要放入自己有权保存和发布的实际附件，不能把清单里的文件名当作已存在文件。正文样例同时使用标题、列表、围栏代码、相对图片与引用，足以触发常见导出问题。第二个渲染器中任何一项失败，都先记下原始文本与实际显示，区分内容丢失还是样式差异；只影响高亮的差异与图片完全缺失不应判为同等严重。
迁移记录还要求把正文移到另一受控目录后复查，目的是暴露绝对路径依赖。此操作应以复制样本为主，先保留原导出目录；移动或覆盖唯一副本会扩大恢复难度。检查通过后填写实际工具与版本，若某种专用语法被转换，记录转换规则和损失内容。未来换工具时可以从这些记录开始，不必重新猜测哪段文字依赖扩展。所有模板都是普通文本，macOS、GNU/Linux 与 DSM 浏览器下载后均需按实际保存路径使用，不依赖特殊编辑器按钮。