Markdown搬到新目录后图片不见了:检查相对路径

Markdown正文里写的相对路径,需要一个参照位置才能找到图片。移动文件或换发布平台以后,文字仍然存在,图片却可能因为解析规则变化而失效。

有时间线与新闻卡片的浅色阅读桌
浅色主题概念配图,选自本站AI生成图库;非事件现场或产品实测截图。

先画出文档与图片的位置

假设notes/readme.md与notes/images/cover.png位于同一目录树,文档可引用images/cover.png。若只把readme.md移到项目根目录,原路径就可能指向另一个位置;应一并移动资源或更新引用。

本地预览与网站规则可能不同

GitHub仓库会按其文档位置处理相对引用,其他编辑器或静态站点可能有不同的基础路径设置。以斜杠开头的路径也需要结合发布环境理解,不能把电脑上的绝对路径直接当成公开图片地址。

迁移时做小型资源清单

列出图片、附件和页面链接,核对文件名大小写与实际目录,再用目标平台预览。不要只检查首页;文章中较深的目录往往更容易漏改。引用私人文件时,还要确认发布后不会意外公开原本受限的材料。

资料与继续学习

GitHub:Markdown链接与图片语法。资料查阅日期:2026年9月25日。步骤与练习由本站整理。

资料查阅与编辑日期:2026年9月25日。作者:玖柒。

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享