Чтобы сохранить веб-страницу как Markdown, сохраните её в Chrome или Edge сочетанием Ctrl+S как «Веб-страница, полностью», а затем добавьте файл HTML в MD Factory. Приложение преобразует страницу на вашем ПК и сохранит рядом файл Markdown с изображениями страницы.
Это руководство для страниц, которые вы храните для себя: статей, документации, рецептов, справочных страниц. Если вам нужно преобразовывать HTML в скрипте или при сборке, переходите к последнему разделу.
Сохранение страницы в Chrome или Edge
В Chrome нажмите Ctrl+S или откройте меню «Ещё», выберите «Трансляция, сохранение и отправка», а затем «Сохранить страницу как». Эти шаги описаны в справке Chrome.
В Edge нажмите Ctrl+S. Это сочетание клавиш есть в списке сочетаний клавиш Edge.
В списке «Тип файла» выберите «Веб-страница, полностью». Оба браузера предлагают три формата, и MD Factory обрабатывает их по-разному:
| Тип файла | Что сохраняет браузер | Что вы получите в MD Factory |
|---|---|---|
| Веб-страница, полностью | Файл HTML и папка с тем же именем и окончанием _files, в которой лежат изображения | Текст и изображения |
| Веб-страница, только HTML | Только файл HTML; изображения остаются на сайте | Текст без изображений, со статусом «Требуется проверка» |
| Веб-страница, один файл | Один файл MHTML | Ничего: MD Factory не открывает файлы MHTML и помечает их как пропущенные |
Преобразование сохранённой страницы
- Откройте MD Factory.
- Нажмите «Добавить файлы» и выберите сохранённый файл HTML или перетащите его в окно.
- Преобразование начинается сразу. Когда в строке появится результат, дважды щёлкните путь к результату, чтобы открыть файл Markdown.
Добавляйте файл HTML, а не папку, в которой он лежит. Если добавить папку, MD Factory пройдёт и по папке _files: её скрипты, таблицы стилей и изображения попадут в список пропущенных, а все файлы HTML внутри неё будут преобразованы в отдельные заметки.
Файл Markdown получает имя страницы и сохраняется рядом с ней. Используемые им изображения попадают в папку рядом:
Saved pages/
Sourdough bread.html
Sourdough bread_files/
Sourdough bread.md
Sourdough bread_images/Сохранённая страница и её папка _files остаются как были. Если вы перемещаете файл Markdown, перемещайте вместе с ним папку _images: Markdown ссылается на картинки в этой папке.
Что переходит в Markdown
| На странице | В Markdown |
|---|---|
| Заголовки | Заголовки того же уровня |
| Абзацы, списки и цитаты | Сохраняются, включая полужирный и курсивный текст |
| Блоки кода и код в строке | Сохраняются как код |
| Таблицы | Таблицы Markdown |
| Изображения, сохранённые вместе со страницей | Копируются в папку изображений в виде файлов PNG |
| Ссылки | Сохраняются, как описано ниже |
| Скрипты, стили и встроенные фреймы, например видеоплееры с других сайтов | Удаляются |
| Меню сайта, верхние и нижние колонтитулы, боковые панели и уведомления о cookie | Сохраняются как обычный текст и ссылки |
| Заголовок на вкладке браузера | Не включается |
Если в таблице есть ячейки заголовка, её первая строка становится заголовком таблицы Markdown. Иначе приложение добавляет пронумерованные заголовки столбцов. Объединённые ячейки раскладываются по сетке: значение остаётся в первой ячейке, а покрытые ею ячейки остаются пустыми.
Какие изображения сохраняются
MD Factory ничего не скачивает из интернета. Изображение попадает в Markdown, только если его файл есть на вашем ПК:
- изображения из папки _files, которую создаёт «Веб-страница, полностью»;
- изображения из других папок рядом со страницей, включая папки уровнем выше;
- изображения, встроенные прямо в код HTML.
Изображение, которое есть только на сайте, пропускается, а файл получает статус «Требуется проверка». Изображения SVG не поддерживаются и тоже пропускаются.
Как обрабатываются ссылки
- Полные веб-адреса, ссылки на электронную почту и телефонные ссылки остаются без изменений.
- Относительные ссылки, например на другую страницу того же сайта, становятся полными веб-адресами, если в сохранённой странице записан её исходный адрес. Иначе они остаются как есть и работают, только если файл, на который они указывают, лежит там же относительно файла Markdown.
- Ссылки на раздел той же страницы продолжают работать, потому что разделы сохраняют свои якоря в Markdown.
- Ссылки, запускающие скрипт при нажатии, то есть начинающиеся с javascript:, становятся обычным текстом.
Наведение порядка в заметке
MD Factory преобразует всё тело страницы. Он не пытается угадать, какая часть является статьёй, поэтому ждите меню сайта вверху, а внизу колонтитул, связанные ссылки и уведомление о cookie. Удалите то, что вам не нужно.
Заголовок с вкладки браузера не включается. Если собственного заголовка статьи нет, добавьте его в начало.
Добавьте адрес страницы и дату сохранения первой строкой заметки. Так вы потом найдёте оригинал и сможете сослаться на него при цитировании.
Если вы ведёте заметки в Obsidian, наше руководство по импорту документов в Obsidian рассказывает, как преобразовывать файлы в хранилище и сохранять ссылки на их изображения.
Если страница получила «Требуется проверка»
«Требуется проверка» означает, что файл Markdown сохранён, но что-то со страницы не перенеслось. Когда очередь закончит работу, нажмите на статус в строке файла, чтобы увидеть сообщение.
| Сообщение | Обычная причина |
|---|---|
| Внешнее изображение или ресурс пропущен. | Изображение есть только на сайте, например после сохранения как «Веб-страница, только HTML». |
| Не удалось экспортировать изображение. | Страница ссылается на файл изображения, которого нет в папке. |
| Формат изображения не поддерживается. | Изображение в формате, который приложение не умеет преобразовывать, например SVG. |
| Часть содержимого не удалось представить в Markdown. | На странице был встроенный фрейм, например видеоплеер с другого сайта, и он удалён. |
| Не удалось сохранить цель локальной ссылки. | Ссылку на другую страницу сайта не удалось сопоставить ни с веб-адресом, ни с сохранённым файлом. Текст ссылки сохранён без самой ссылки. |
| Кодировка определена автоматически. Проверьте специальные символы. | Страница сохранена не в UTF-8, поэтому приложению пришлось определять кодировку. Проверьте буквы с диакритикой и символы. |
Преобразование HTML в коде
Если вам нужно преобразовывать HTML в Markdown в скрипте, на этапе сборки или в парсере, MD Factory не подойдёт: он работает через окно, без командной строки и программного интерфейса. Используйте библиотеку. Turndown преобразует HTML в Markdown на JavaScript, в Node.js или в браузере, по лицензии MIT. html2text делает то же самое на Python по лицензии GPL-3.0. Pandoc — консольный конвертер между многими форматами документов, включая HTML и Markdown. С любой из этих библиотек правила преобразования, изображения и ссылки вы настраиваете сами.
pandoc -f html -t gfm page.html -o page.md