Как написать файл Markdown, который импортируется в JW Library
Напишите заметку в Блокноте, TextEdit или Obsidian — и она встанет на нужный стих в JW Library. Какие именно строки набрать и что можно опустить.
JW Sync умеет вчитывать файлы Markdown в резервную копию JW Library, и как только вы узнаёте об этой возможности, остаётся единственный по-настоящему важный вопрос: а как должен выглядеть сам файл? Эта страница отвечает на него со стороны того, кто пишет, — не что примет импорт, а что вы набираете на клавиатуре.
Если коротко, заметка — это текстовый файл. Создайте файл, напишите заметку, сохраните с .md на конце — и он импортируется. Всё остальное здесь про одну необязательную строку: ту, что говорит, какому месту Писания принадлежит заметка, чтобы она появлялась в JW Library при чтении этого стиха, а не лежала отдельно среди прочих заметок.
Ничего из этого не требует редактора Markdown и не требует учить Markdown. Блокнота в Windows и TextEdit на Mac достаточно. Если вы уже ведёте учебные заметки в Obsidian или Notion, эти файлы и так Markdown — для каждого ниже есть свой раздел.
Шаг за шагом
Откройте любой редактор простого текста
Блокнот в Windows, TextEdit на Mac или то приложение для Markdown, которым вы уже пользуетесь, — Obsidian, Typora, iA Writer, Joplin. Избегать стоит только текстового процессора: Word и Google Документы сохраняют оформление, а не простой текст, и ни один из них не даёт файла, который импорт сможет прочитать.
Наберите заметку
Поставьте заголовок в первой строке, а перед ним #, оставьте пустую строку и напишите заметку ниже. Это уже полноценный, годный файл. Если писать строку заголовка не хочется, вместо неё возьмут имя файла.
Сохраните с .md на конце
Называйте как угодно: моя заметка.md. В Windows Блокнот сохранит .txt, пока вы не смените «Тип файла» на «Все файлы», — на этом спотыкаются чаще всего. На Mac перед сохранением выберите Формат, а затем Преобразовать в обычный текст.
Добавьте строку, которая ставит заметку на стих
В самом начале файла, выше всего остального, напишите строку из трёх дефисов, затем publication: Matthew 26:39, затем снова три дефиса. Теперь заметка привязана к этому стиху. Если этого не делать, заметка всё равно импортируется — просто придёт непривязанной.
Импортируйте её в резервную копию
В JW Library откройте «Личное изучение», нажмите меню из трёх точек, выберите «Резервное копирование и восстановление» и создайте копию. Загрузите этот файл на jwsync.org в «Обозреватель изучения», нажмите «Импорт Markdown», выберите свои файлы .md и прочитайте сводку, которую вам покажут прежде, чем что-либо будет записано. Затем нажмите «Выгрузить .jwlibrary» и восстановите этот файл в JW Library.
Самый короткий файл, который сработает
Файл, в котором нет ничего, кроме текста, — уже годная заметка. Вот он целиком:
# Чаша, о которой он молился Его молитва показывает покорность, а не нежелание.
Строка, начинающаяся с #, становится заголовком заметки, а всё, что ниже, — самой заметкой. Такой файл импортируется без возражений. Он просто приходит отдельной заметкой, лежащей среди ваших заметок, а не привязанной к месту Писания.
Как создать файл в Windows
Откройте Блокнот, наберите заметку, затем выберите «Файл» и «Сохранить как». Перед сохранением смените «Тип файла» с «Текстовые документы» на «Все файлы» — без этого шага Блокнот тихо допишет .txt, и у вас получится моя заметка.md.txt, которого импорт не увидит. Потом наберите имя с .md на конце. Windows может предупредить, что смена расширения способна сделать файл непригодным; это предупреждение и есть признак того, что вы всё сделали верно.
Как создать файл на Mac
Откройте TextEdit и выберите «Формат», а затем «Преобразовать в обычный текст», прежде чем что-то набирать. TextEdit запускается в режиме форматированного текста и сохраняет .rtf, а это вообще не текстовый файл. Оказавшись в режиме обычного текста, выберите «Файл» и «Сохранить» и завершите имя на .md. Если macOS предложит дописать .txt, откажитесь.
Как создать файл на телефоне или планшете
Подойдёт любое приложение, умеющее сохранять или выгружать Markdown, — Obsidian, Bear, iA Writer, Joplin, Markor на Android. Встроенные «Заметки» на iPhone и Android обычно не умеют сохранять файл .md, так что на телефоне обычный путь — одно из этих приложений или просто работа на компьютере. При импорте можно выбрать сколько угодно файлов сразу, а целую папку можно упаковать и отдать одним .zip.
Та самая строка, что ставит заметку на стих
Всё, что говорит импорту, куда относится заметка, помещается в небольшой блок в самом начале файла, между двумя строками из трёх дефисов. Он называется front matter, и для большинства заметок это одна строка:
--- publication: Matthew 26:39 --- # Чаша, о которой он молился Его молитва показывает покорность, а не нежелание.
Эта заметка теперь привязана к Матфея 26:39. Она появляется в JW Library, пока вы читаете этот стих, ровно так, как если бы вы написали её прямо в приложении.
Как записать ссылку, чтобы её поняли
Название книги пишите по-английски, даже если сама заметка на другом языке: Matthew, а не Матфея. Понимаются и те сокращения, которые люди действительно набирают, — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Между главой и стихом можно ставить двоеточие, точку или букву v, так что John 3:16, John 3.16 и 1 Cor 13 v4 значат одно и то же, а пробелы необязательны, поэтому 1Cor13:4 тоже годится. Диапазон вроде Matthew 26:39-41 ставит заметку на первый стих, 39-й, потому что заметка в JW Library крепится к одной точке текста, а не к отрезку.
Полный файл — с заголовком, датой и метками
Есть ещё три строки, если они вам нужны, и все они необязательны:
--- title: Чаша, о которой он молился date: 2026-08-15 tags: [изучение, гефсимания] publication: Matthew 26:39 --- Его молитва показывает покорность, а не нежелание.
title делает то же, что заголовок с #, так что достаточно чего-то одного. date задаёт дату заметки вместо дня, когда вы её импортировали. tags превращаются в настоящие метки JW Library, по которым можно фильтровать, а уже существующая метка используется повторно, а не дублируется. Строку tags можно написать и как изучение, гефсимания без скобок, и как #изучение #гефсимания, и списком с дефисами на отдельных строках ниже — все четыре записи читаются одинаково.
Одна заметка на файл
Каждый файл .md становится одной заметкой. Положить несколько заметок в один файл и заставить их разделиться нельзя: ничто в файле Markdown не отмечает надёжно, где кончается одна заметка и начинается следующая — заголовок посреди файла может быть и второй заметкой, и подзаголовком первой, а ошибка разбросала бы написанное вами. Поэтому пишите по файлу на заметку, а при импорте выбирайте их все разом или упакуйте папку и выберите .zip.
Какое оформление доходит целым
Абзацы, переносы строк, полужирный, курсив и маркированные списки приходят в JW Library настоящим оформлением. Заголовки после первого становятся обычными абзацами. Всё, что Markdown умеет выразить, а заметка JW Library — нет (таблицы, изображения, ссылки, блоки кода), сводится к тексту, так что слова выживают даже там, где вёрстка за ними не поспевает.
Если вы уже пишете в Obsidian
Файлы Obsidian и так Markdown, а его панель свойств пишет ровно тот front matter, что описан здесь: добавьте свойство publication со значением Matthew 26:39 — и заметка встанет туда. Собственное свойство tags в Obsidian читается как tags. Ссылки в двойных квадратных скобках и встроенные заметки сводятся к тексту, ведь заметке JW Library некуда ими указывать. Можно выбрать все .md целой папки за один импорт или упаковать папку и отдать .zip.
Если вы уже пишете в Notion
Notion умеет выгружать Markdown: откройте меню страницы, выберите «Экспорт» и укажите «Markdown & CSV». На выходе получится .zip, который импорт принимает как есть. Notion пишет заголовок страницы как заголовок, а собственные свойства — обычными строками ниже, и поля, которых импорт не знает, просто игнорируются, а не считаются ошибкой. Так что, чтобы поставить заметку на стих, допишите строку publication в начало выгруженного файла сами.
Что необязательно делать безупречно
Заглавные буквы в названиях полей роли не играют. Пробел после двоеточия может отсутствовать. Лишние пробелы и табуляции игнорируются, как и кавычки вокруг значения и комментарий после #. Переводы строк из Windows не мешают. Можно вообще обойтись без строк --- и начать файл прямо с полей, лишь бы самая первая строка была одним из них. А если вы ошибётесь в названии книги — Mathew, — импорт скажет, что прочитал это как Matthew 26:39, и подождёт, пока вы поставите галочку, вместо того чтобы решать самому.
Чего импорт не сделает с вашей библиотекой
Импорт только добавляет. Заметки, выделения, закладки и метки, которые уже есть в вашей копии, остаются нетронутыми, а загруженный файл никогда не изменяется — в конце вы скачиваете новый .jwlibrary и восстанавливаете именно его. Заметка, у которой заголовок, текст и место совпадают с чем-то уже имеющимся в копии, пропускается, поэтому импортировать одни и те же файлы дважды — ничего не удвоить. Всё, что добавляет импорт, отменяется одним шагом «Отменить», а импортированные заметки получают метку Imported, так что потом их можно найти, отфильтровать или удалить целой группой. Ничего из этого не покидает ваше устройство.
Частые вопросы
- Нужно ли сначала выучить Markdown?
- Нет. Файл с обычными предложениями — уже годная заметка. Markdown понадобится, только если захотите полужирный, курсив или маркеры, да и там это две звёздочки вокруг слова для полужирного и дефис в начале строки для маркера.
- Важно ли имя файла?
- Только когда у файла нет собственного заголовка. Если нет ни строки title:, ни заголовка с #, имя файла приводят в порядок и берут вместо заголовка: chasha-o-kotoroj-on-molilsya.md станет заметкой «chasha o kotoroj on molilsya». В остальном называйте файл как угодно.
- А если я случайно сохранил его как .txt?
- Переименуйте так, чтобы он оканчивался на .md, и импортируйте снова — в содержимом менять нечего. В Windows, возможно, сначала придётся включить расширения имён файлов в меню «Вид» Проводника, иначе окончание от вас скрыто.
- Можно ли писать название книги на своём языке?
- Пока нет. Названия книг распознаются по-английски, и именно так их пишет выгрузка Markdown с этого сайта. Саму заметку пишите на любом языке; английское название нужно только строке со ссылкой. Если не хочется, опустите ссылку и расставьте заметку вручную позже.
- Можно ли положить несколько заметок в один файл?
- Нет — каждый файл становится одной заметкой. Выберите за один импорт сколько угодно файлов или упакуйте папку и выберите .zip.
- Изменит ли это заметки, которые у меня уже есть?
- Нет. Импорт только добавляет. Ваши имеющиеся заметки остаются нетронутыми, а загруженная копия никогда не изменяется: в конце вы скачиваете новый файл и сами решаете, восстанавливать ли его.
- Что будет, если пропустить строку со ссылкой?
- Заметка всё равно импортируется. Она придёт в библиотеку отдельной заметкой, а не привязанной к месту Писания, — а именно этого обычно и хочет заметка о речи, разговоре или личном размышлении.