Документация

Импорт и экспорт

Как перенести заметки в Блокнотик из Markdown, текстовых файлов и zip-архивов и как выгрузить их обратно — архивом Markdown или маленьким статическим сайтом.

Оба направления — в «Меню» справа вверху. Ни то ни другое никогда не меняет и не удаляет существующие заметки.

Импорт

«Меню → Импорт файлов…» открывает обычное окно выбора файлов. Можно выбрать сразу несколько:

  • **.md и .markdown** — копируются в основную папку заметок как файлы .md.
  • **.txt** — копируются так же и получают расширение .md. Простой текст — это корректный Markdown, так что всё работает; разве что переносы строк могут выглядеть иначе.
  • **.zip** — каждый файл .md, .markdown и .txt внутри становится заметкой, причём папки сохраняются: Рецепты/Хлеб.md из архива окажется в Blocknotik/Рецепты/Хлеб.md. Картинки из архива (PNG, JPEG, GIF, WebP, SVG, AVIF) копируются вместе с заметками, чтобы ссылки на них продолжали работать.

Сообщение после импорта скажет, сколько файлов загружено и сколько пропущено.

Если имена совпадают

Ничего не перезаписывается. Если в этой папке уже есть заметка с таким именем, к новой добавляется номер: Хлеб 2.md. Картинка с уже занятым именем пропускается, существующий файл остаётся.

Что пропускается

  • Файлы других типов внутри zip (PDF, документы, программы).
  • Скрытые файлы и папки, а также папки __MACOSX, которые добавляют некоторые архиваторы.
  • Файлы больше 8 МБ, больше 5000 файлов из одного архива и загрузки больше 200 МБ в сумме.

Пути внутри zip очищаются до того, как что-либо будет записано: .., буквы дисков и абсолютные пути убираются, так что архив не может положить файлы за пределы папки с заметками.

Переезд из другой программы для заметок

Большинство программ для заметок умеют выгружать Markdown, часто — zip-архивом. Импортируйте этот архив как есть. Что проверить потом:

  • Ссылки: если прежняя программа использовала [[двойные скобки]], они заработают, когда названия совпадают с именами файлов. Markdown-ссылки на файлы .md в просмотре тоже работают.
  • Front matter (служебные данные между строками --- в начале) не разбирается и будет виден как текст; удалите его или оставьте.
  • Вложения, которые не являются картинками, не переносятся — храните их в исходной выгрузке.

Если ваши заметки и так лежат папкой Markdown-файлов, импорт вообще не нужен: запустите Блокнотик с --dir, указав эту папку.

Экспорт

Markdown (.zip)

«Меню → Экспорт в Markdown (.zip)» скачивает blocknotik-ГГГГ-ММ-ДД-md.zip со всеми заметками и картинками ровно в том виде, в каком они лежат на диске, вместе с папками. Папка .trash и скрытые файлы в архив не попадают. Это и резервная копия, и способ передать заметки другой программе.

HTML (.zip)

«Меню → Экспорт в HTML (.zip)» превращает заметки в маленький статический сайт:

  • по странице .html на каждую заметку, в тех же папках;
  • index.html со списком всех заметок и разделом для каждого тега;
  • style.css со светлыми и тёмными цветами;
  • картинки, скопированные рядом со страницами.

Ссылки между заметками становятся обычными относительными ссылками, поэтому сайт работает и при открытии прямо с диска (двойной щелчок по index.html), и на любом веб-сервере. Ссылки на теги ведут к разделам тегов на главной странице. Ссылки на несуществующие заметки никуда не ведут.

На страницах нет скриптов, и они ничего не загружают из интернета.

Печать и PDF

Отдельного экспорта в PDF нет. Откройте заметку в режиме «Просмотр» и воспользуйтесь печатью браузера (Ctrl+P, «Сохранить как PDF») или распечатайте страницу из HTML-экспорта.