TUMBLINGCAT / 使用指南

Markdown 图片不显示?按路径、权限和网络逐项检查

Markdown 正文能打开,不代表它引用的图片也能被读取。先判断图片来自本地文件还是网络地址,再检查路径、文件访问权限和格式,就能缩小问题范围。

更新于

先在源码里看图片地址

切换到源码视图,找到 ![说明](图片地址)。assets/photo.png 是相对于文档位置的本地路径;https:// 开头通常是网络图片。两种地址需要分别排查。

把文档切换到阅读视图后再确认显示效果;只看到源码中的图片标记,不代表附件本身已经损坏。

本地图片:同时检查文档和附件的位置

  1. 如果正文写着 ![照片](assets/photo.png),确认 .md 旁边存在 assets 文件夹,里面有 photo.png;检查文件名、扩展名和大小写是否一致。
  2. 如果刚把文档发到手机或移动了文件夹,检查是否只复制了 .md。请保持文档和附件的相对目录关系。
  3. 在滚猫 Windows 版中,本地图片需位于文档所在目录或其子目录。将图片复制到文档旁的 assets/,再使用相对路径;父目录路径、绝对路径与目录外符号链接不会读取。

Android:给文档所在文件夹授权

  1. 从系统文件选择器打开 Markdown。在“更多 → 关联图片文件夹”中选择直接包含这份 .md 的文件夹。
  2. 按系统提示授予目录访问权限,再检查相对图片。无需给应用整盘存储权限。
  3. 部分文件提供器不支持关联目录。可以先把文档和附件复制到能通过系统选择器访问的位置,再重新打开并关联;也可以在电脑上转换为 TextPack。

网络图片:确认网址仍然可用

用浏览器打开图片网址,确认文件仍在、网络可访问,且不是只能在原网站登录后查看的资源。原网站更换链接或限制外部访问时,笔记里的旧地址可能失效。

原生版粘贴网页图片和导出远程图片支持公网 HTTPS 的 PNG、JPEG、GIF 与 WebP,并有下载数量、体积和超时限制。无法下载时应检查结果提示;普通显示、粘贴和导出是不同操作,某一步成功不保证其他步骤也能完成。

检查格式,并让下次传文件更省事

本地图片支持 PNG、JPEG、GIF 和 WebP,单张最多 32 MiB;SVG 暂不支持。遇到不支持的格式,可以先转换为支持的图片格式,再更新链接。

图片恢复显示后,可以把 Markdown 与可访问的本地图片另存为 TextPack。先在另一台设备打开检查,再分享给他人;已有网络图片链接仍依赖原网址。

功能与限制依据项目公开文档;本指南对应 Windows v0.5.1 / Android v0.5.2。 使用文档

READ. WRITE. TAKE IT WITH YOU.

Markdown 使用指南

查看全部使用指南