Markdown 文件可以引用图片,但文件本身并不包含图片数据。因此,如果只复制这个文本文件,文档读起来可能很通顺,但原本放图表的位置会变成空白。
PDF Craft 将 Markdown 结果打包成 ZIP 下载。在编辑或移动其中的 Markdown 文档之前,请先完整解压;只在压缩包里预览,可能看不出它与配套图片之间的关联。
确认文档及其依赖文件
从已完成的 PDF 转 Markdown 任务下载 ZIP,并解压到一个单独的文件夹。压缩包里包含 Markdown 文档,如果生成了图片资源,还会包含对应的文件夹。导出时的命名可能不同:文档可能沿用源文件名,也可能叫 document.md 之类的名字;资源可能放在 images/ 下,也可能放在 assets/ 下。用文本编辑器打开 .md 文件,按照它实际写的链接去找文件,不要为了套用示例而重命名文件夹。请保留原始 ZIP,作为未改动过的副本。
链接可以指向相对路径的文件、本地绝对路径,或远程 URL,三者的可移植性各不相同。相对路径的文件需要保留它旁边的资源;远程 URL 则要求能联网,并且该地址上的文件一直可用。
还要确认图注和图号是文档里的文字,还是图片的一部分。保留图片,并不等于图片里的每个字都被识别或翻译过。图片与图注检查指南介绍了如何处理这类内容关系。
从 Markdown 文件所在位置理解相对路径
关键在于 Markdown 文件与资源文件夹的相对位置。下面是一个简化示例,文档名和图片名都是占位符,请以你实际下载的文件名为准:
paper/
├── notes.md
└── images/
└── figure-1.png
对应的 Markdown 可能写成:

编辑器会以 notes.md 所在位置为基准,查找 images/figure-1.png。把整个 paper 文件夹一起移动,链接关系就能保持不变;只移动 notes.md,图片可能就不在链接指向的位置了。
文件名的大小写、空格、扩展名和编码字符在不同系统上可能造成差异。实际文件名与链接中写的名字不一致时,在一台电脑上能显示的图片,传到另一台电脑后可能就无法显示。
移动整个工作文件夹
原始下载文件保持不动。新建一个工作副本,放入 Markdown 以及它用到的所有本地资源,先保持原有目录结构。等你确认原始结构能正常打开之后,再重新整理。
如果要给资源文件夹改名,记得同步修改对应的链接,并抽查几张图。不要把多个文档里那些通用文件名直接放进同一个文件夹,除非事先想好命名规则。两个都叫 image1.png 的文件可能互相覆盖,或者被弄混。
导入笔记应用时,要弄清它是把附件复制过去,还是只链接到原位置。Obsidian 导入指南介绍了一种外部工作流程。PDF Craft 的导出并不代表会自动同步到你的笔记库,也不代表图片会被永久托管。
分享文件,而不只是预览
如果对方需要一份能独立使用的本地副本,请把文档和它必需的资源一起打包,例如用文件管理器把整个文件夹压缩。把这份副本放到另一个位置测试,不要依赖你自己电脑上的路径。
如果要把 Markdown 发布到网站上,请遵守该网站的资源上传和 URL 规则。指向你本机的 file:/// 路径,远程读者无法访问。不要仅仅为了修复预览中的图片,就把私密的原始图片上传到公共服务器。
分享文档和插图前,请先确认你有权分享。转换后的图片仍属于原作品的一部分;转换并不会让它变成可以自由使用的新素材。
按固定顺序排查图片无法显示的问题
- 读取 Markdown 源码里的链接。
- 判断它指向的是本地文件还是远程 URL。
- 检查该文件是否存在于预期路径,或远程地址是否可以访问。
- 核对文件名、大小写和扩展名。
- 直接打开图片,排除文件不完整或格式不受支持的可能。
- 在目标阅读器中重新打开 Markdown,检查图注和上下文。
如果下载的内容里缺少该资源,请对照源 PDF 并记录缺失情况。不要用生成的近似图替换技术图表。在解决缺失内容之前,请保留标注清楚的源页码。
路径能正常使用之后,把源标题、版本和图的位置记入你的研究笔记。一份便于携带的文档,既需要可用的链接,也需要能查清图片出处的依据。