Файл Markdown может ссылаться на изображение, но не содержать самих данных этого изображения. Если скопировать только текстовый файл, документ будет читаться, однако на месте схем останутся пустые места.
В PDF Craft результаты конвертации в Markdown можно скачать в виде ZIP-архива. Распакуйте архив целиком, прежде чем редактировать или переносить документ Markdown: если открыть только предпросмотр внутри ZIP, связь с прилагаемыми изображениями останется незаметной.
Определите документ и его зависимости
Скачайте ZIP-архив из завершённой задачи «PDF в Markdown» и распакуйте его в отдельную папку. В пакете есть документ Markdown и, если при экспорте создаются изображения, папка с ними. Имена при экспорте могут различаться: документ может называться по имени исходного файла или, например, document.md, а ресурсы лежать в images/ или assets/. Откройте файл .md в текстовом редакторе и ориентируйтесь на фактические ссылки в нём, а не переименовывайте папки под пример. Исходный ZIP сохраните как неприкосновенную копию.
Ссылка может содержать относительный путь, абсолютный локальный путь или удалённый URL. От этого зависит, сохранится ли доступ к изображению при переносе документа. При относительном пути нужно сохранить расположение файла изображения относительно документа; при удалённом URL нужны доступ к сети и доступность изображения по тому же адресу.
Проверьте, являются ли подписи и номера рисунков текстом в документе или частью самого изображения. Наличие картинки не означает, что каждое слово на ней распознано или переведено. О том, как связаны изображения и подписи, рассказывает руководство по изображениям и подписям в отсканированных PDF.
Читайте относительный путь от места, где лежит файл Markdown
Главное — взаимное расположение файла Markdown и папки с ресурсами. Ниже упрощённый пример с условными именами документа и изображения; в своём архиве смотрите фактические имена:
paper/
├── notes.md
└── images/
└── figure-1.png
Соответствующий Markdown может выглядеть так:
Редактор ищет images/figure-1.png относительно notes.md. Перенесите папку paper целиком — и связь сохранится. Перенесите только notes.md — и изображения может не оказаться там, где его ждёт ссылка.
В разных системах значение имеют регистр букв в именах файлов, пробелы, расширения и закодированные символы. Изображение, которое видно на одном компьютере, может перестать отображаться после переноса, если фактическое имя файла не совпадает с указанным в ссылке.
Переносите рабочую папку целиком
Не трогайте исходную скачанную копию. Создайте рабочую копию с документом Markdown и всеми локальными ресурсами, которые он использует, сохранив структуру папок. Перестраивайте её только после того, как убедились, что исходное расположение открывается правильно.
Если переименовываете папку с ресурсами, обновите соответствующие ссылки и проверьте несколько рисунков. Не складывайте в одну папку файлы с типовыми именами из разных документов без продуманной схемы имён. Два разных файла image1.png могут перезаписать друг друга или перепутаться.
При импорте в приложение для заметок выясните, копирует оно вложения или только ссылается на их исходное расположение. Руководство по импорту в Obsidian описывает один из внешних сценариев работы. Экспорт из PDF Craft не означает автоматической синхронизации с хранилищем заметок или постоянного размещения изображений.
Передавайте файлы, а не только предпросмотр
Если другому человеку нужна переносимая локальная копия, передайте документ вместе с необходимыми ресурсами — например, архивом папки, созданным средствами файлового менеджера. Проверьте переданную копию из другого расположения, а не полагайтесь на пути, оставшиеся на вашем компьютере.
Если вы публикуете Markdown на сайте, соблюдайте правила сайта по загрузке ресурсов и формированию URL. Путь вида file:///, указывающий на ваше устройство, не даст удалённому читателю доступа к файлу. Не загружайте конфиденциальные исходные иллюстрации на публичный хостинг только ради того, чтобы исправить предпросмотр.
Убедитесь, что у вас есть право делиться документом и иллюстрациями. Преобразованное изображение остаётся частью исходного произведения; конвертация не делает его новым свободно распространяемым материалом.
Ищите причину неработающего изображения в определённом порядке
- Прочитайте ссылку в исходном файле Markdown.
- Определите, ожидается ли по ней локальный файл или удалённый URL.
- Проверьте, существует ли этот файл по ожидаемому пути или доступен ли удалённый адрес.
- Сравните имя файла, регистр букв и расширение.
- Откройте само изображение, чтобы исключить неполный или неподдерживаемый файл.
- Снова откройте Markdown в нужной программе и проверьте подпись и окружение рисунка.
Если ресурса нет в скачанном архиве, сверьтесь с исходным PDF и зафиксируйте пропуск. Не заменяйте техническую схему сгенерированным приближением. Пока вы разбираетесь с недостающим содержимым, сохраняйте явно обозначенную ссылку на страницу источника.
Когда пути работают, сохраняйте название источника, издание и расположение рисунков вместе с заметками для исследования. Переносимому документу нужны и рабочие ссылки, и возможность установить, откуда взялись изображения.