TUMBLINGCAT / 使用指南
Markdown 图片不显示?按路径、权限和网络逐项检查
Markdown 正文能打开,不代表它引用的图片也能被读取。先判断图片来自本地文件还是网络地址,再检查路径、文件访问权限和格式,就能缩小问题范围。
更新于
先在源码里看图片地址
切换到源码视图,找到 。assets/photo.png 是相对于文档位置的本地路径;https:// 开头通常是网络图片。两种地址需要分别排查。
把文档切换到阅读视图后再确认显示效果;只看到源码中的图片标记,不代表附件本身已经损坏。
本地图片:同时检查文档和附件的位置
- 如果正文写着 ,确认 .md 旁边存在 assets 文件夹,里面有 photo.png;检查文件名、扩展名和大小写是否一致。
- 如果刚把文档发到手机或移动了文件夹,检查是否只复制了 .md。请保持文档和附件的相对目录关系。
- 在滚猫 Windows 版中,本地图片需位于文档所在目录或其子目录。将图片复制到文档旁的 assets/,再使用相对路径;父目录路径、绝对路径与目录外符号链接不会读取。
Android:给文档所在文件夹授权
- 从系统文件选择器打开 Markdown。在“更多 → 关联图片文件夹”中选择直接包含这份 .md 的文件夹。
- 按系统提示授予目录访问权限,再检查相对图片。无需给应用整盘存储权限。
- 部分文件提供器不支持关联目录。可以先把文档和附件复制到能通过系统选择器访问的位置,再重新打开并关联;也可以在电脑上转换为 TextPack。
网络图片:确认网址仍然可用
用浏览器打开图片网址,确认文件仍在、网络可访问,且不是只能在原网站登录后查看的资源。原网站更换链接或限制外部访问时,笔记里的旧地址可能失效。
原生版粘贴网页图片和导出远程图片支持公网 HTTPS 的 PNG、JPEG、GIF 与 WebP,并有下载数量、体积和超时限制。无法下载时应检查结果提示;普通显示、粘贴和导出是不同操作,某一步成功不保证其他步骤也能完成。
检查格式,并让下次传文件更省事
本地图片支持 PNG、JPEG、GIF 和 WebP,单张最多 32 MiB;SVG 暂不支持。遇到不支持的格式,可以先转换为支持的图片格式,再更新链接。
图片恢复显示后,可以把 Markdown 与可访问的本地图片另存为 TextPack。先在另一台设备打开检查,再分享给他人;已有网络图片链接仍依赖原网址。
功能与限制依据项目公开文档;本指南对应 Windows v0.5.1 / Android v0.5.2。 使用文档