Markdown 文章迁移时，最容易丢的是图片和锚点

很多人一说文章迁移，会先想到正文是不是完整、标题和日期有没有带过去。
这些当然重要，但 2016 年我在整理和迁移一批 Markdown 内容时，最让我头疼的反而不是纯文本，而是那些看起来像细节、丢了却很影响阅读体验的东西。

最典型的就是图片和锚点。

为什么图片最容易在迁移里出问题

正文文字通常还能通过复制、脚本或简单转换保住，可图片一旦涉及：

• 相对路径
• 旧图床域名
• HTML 混写
• 文件名里有空格或中文

迁移链路里任何一层处理不稳，最后就会出现“文章还在，图全没了”的情况。

而且图片问题往往不是立即报错，而是上线后读者点进去才发现。

锚点和目录为什么也不能忽略

很多技术文章会有目录跳转、标题锚点、文内链接。
只要渲染规则稍微一变，原来能跳到的位置就可能失效，结果是页面能打开，但阅读体验明显断掉。

这类问题比图片更隐蔽，因为肉眼扫正文时不一定会第一时间发现。

我后来迁移内容时最在意的检查项

哪怕只是小批量迁移，我也会至少核对：

• 图片是否还能访问
• 目录链接是否能跳到正确标题
• 文内相对链接是否还是有效地址
• 截图说明和上下文是否仍然对得上

这些项比“正文是不是拷过去了”更接近真实可用性。

小结

Markdown 迁移真正难的，不是把字搬过去，而是把文章原本的可读结构一起搬过去。
图片、锚点、目录、链接这些细节平时存在感不强，迁移时却最容易折损内容质量。我后来每次做这类工作，都会先盯住这些点，因为它们最容易被忽视，也最容易伤体验。