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

先画出文档与图片的位置
假设notes/readme.md与notes/images/cover.png位于同一目录树,文档可引用images/cover.png。若只把readme.md移到项目根目录,原路径就可能指向另一个位置;应一并移动资源或更新引用。
本地预览与网站规则可能不同
GitHub仓库会按其文档位置处理相对引用,其他编辑器或静态站点可能有不同的基础路径设置。以斜杠开头的路径也需要结合发布环境理解,不能把电脑上的绝对路径直接当成公开图片地址。
迁移时做小型资源清单
列出图片、附件和页面链接,核对文件名大小写与实际目录,再用目标平台预览。不要只检查首页;文章中较深的目录往往更容易漏改。引用私人文件时,还要确认发布后不会意外公开原本受限的材料。
资料与继续学习
GitHub:Markdown链接与图片语法。资料查阅日期:2026年9月25日。步骤与练习由本站整理。
资料查阅与编辑日期:2026年9月25日。作者:玖柒。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END







