Markdown в FB2: конвертируем с сохранением структуры
- Pandoc — единственный бесплатный конвертер, сохраняющий 95% Markdown-разметки в FB2, но требует установки.
- Онлайн-конвертер Markdown в FB2 справляется за 30 секунд без регистрации и теряет только сложные таблицы.
- В FB2 нет поддержки inline-изображений, поэтому все картинки вставляются как внешние ссылки — это ломает читалки офлайн.
- Конвертация через Calibre даёт на 20% больше ошибок переносов, чем Pandoc, из-за разного парсинга параграфов.
- 1. Почему нельзя просто скопировать Markdown в FB2?
- 2. Самый гибкий способ: Pandoc (командная строка)
- 3. Онлайн-конвертер без установки: быстро и просто
- 4. Конвертация через Calibre: для тех, у кого уже есть библиотека
- 5. Сравнение способов: качество, скорость, удобство
- 6. Подводные камни: что ломается при конвертации
- 7. Частые ошибки и их решение
- 8. Альтернативы: когда FB2 не подходит
1. Почему нельзя просто скопировать Markdown в FB2?
FB2 — это XML-формат со строгой структурой: обязателен корневой элемент <FictionBook>, разделы <body>, <section>, кодировка только UTF-8. Markdown же — лёгкий язык разметки с пробельными отступами. При копировании: пропадают заголовки, списки сливаются, изображения не встраиваются. Пример: маркированный список - пункт в FB2 должен превратиться в
<list type="bullet">
<li><p>пункт</p></li>
</list>Без конвертера это не воспроизвести. Ещё одна боль: FB2 не поддерживает inline-изображения — все картинки хранятся отдельными бинарными блоками в архиве. Если в Markdown есть , при ручном переносе ссылка останется текстом, а читалка её не покажет. Правильный путь — использовать утилиты, понимающие обе спецификации.
2. Самый гибкий способ: Pandoc (командная строка)
Pandoc — швейцарский нож конвертации. Устанавливается через пакетный менеджер: sudo apt install pandoc или brew install pandoc. Базовая команда:
pandoc input.md -o output.fb2Pandoc сам определяет тип входного файла по расширению. Ключевые параметры:
| Параметр | Что делает | Пример |
|---|---|---|
-t fb2 | Явно задаёт формат на выходе | pandoc -t fb2 |
--metadata title:"Моя книга" | Добавляет метаданные (обложка, автор) | --metadata author:"Иванов" |
--from markdown+smart | Включает «умную» типографику (кавычки, тире) | --from markdown+smart |
--resource-path=./img | Путь к изображениям (важно для встраивания) | --resource-path=./images |
Пример с метаданными:
pandoc book.md -o book.fb2 --metadata title:"Война и мир" --metadata author:"Толстой"Подводные камни: Pandoc не поддерживает таблицы с объединёнными ячейками (colspan/rowspan) — они превращаются в простые строки. Также страдают сложные списки (список в списке). Для отладки добавьте --verbose в команду.
3. Онлайн-конвертер без установки: быстро и просто
Если не хотите возиться с командной строкой, используйте Markdown в FB2 на нашем сайте. Это веб-приложение, работающее на базе Pandoc, но с интерфейсом в один клик. Шаги:
- Загрузите .md файл (или вставьте текст).
- Нажмите «Конвертировать».
- Скачайте FB2. Всё занимает 30 секунд.
Конвертер автоматически подхватывает заголовки (H1–H6), маркированные и нумерованные списки, жирный/курсив, ссылки и даже простые таблицы. Ограничения: не встраивает изображения (выдаёт заглушку) и игнорирует LaTeX-формулы. Для чисто текстовых книг — идеальный вариант. Если нужно обратное преобразование, используйте FB2 в Markdown.
Важно: не загружайте файлы больше 50 МБ — сервер может не отработать. Для больших томов используйте локальный Pandoc.
4. Конвертация через Calibre: для тех, у кого уже есть библиотека
Calibre — популярный менеджер электронных книг. Он умеет конвертировать Markdown в FB2, но через промежуточный шаг: сначала нужно импортировать .md как книгу (он сам создаёт метаданные), затем экспортировать в FB2. Инструкция:
- Откройте Calibre, нажмите «Добавить книги», выберите .md файл.
- Выделите добавленную книгу, нажмите «Конвертировать книги» → «Конвертировать по отдельности».
- В поле «Формат вывода» выберите FB2.
- Настройте параметры: вкладка «Структура» — укажите, что разделы начинаются с H1 (или H2).
- Нажмите OK.
Плюсы: Calibre автоматически заполняет метаданные (автор, обложка, язык) из имени файла. Минусы: конвертировать списки может с ошибками — табуляция в Markdown интерпретируется как код, а не как вложенный список. Для простого текста без лишних отступов — норм.
- 1Установка Pandoc
Через пакетный менеджер или скачать с pandoc.org
- 2Подготовка файла
Markdown в кодировке UTF-8, изображения локально
- 3Запуск команды
pandoc in.md -o out.fb2 с нужными метаданными
- 4Проверка XML
Открыть FB2 в редакторе на валидность
- 5Тест в читалке
Загрузить на устройство и проверить отображение
- 6Правка ошибок
Исправить таблицы или списки при необходимости
5. Сравнение способов: качество, скорость, удобство
| Способ | Качество* | Скорость | Сложность |
|---|---|---|---|
| Pandoc | 95% | 2 сек на 100 КБ | Средняя |
| Онлайн-конвертер | 90% | 30 сек с загрузкой | Низкая |
| Calibre | 85% | 10 сек + ручная настройка | Средняя |
| Ручной XML | 100% | часы | Высокая |
* Качество — процент сохранённого форматирования при стандартной разметке.
Вывод: для разовой конвертации — онлайн-конвертер. Для регулярной или с точными метаданными — Pandoc. Calibre оправдан, если вы уже управляете книгами через него.
✅ Чек-лист: проверка качества конвертации
0 из 8
6. Подводные камни: что ломается при конвертации
- Таблицы с объединением ячеек: ни один из способов не поддерживает colspan/rowspan. Результат — строка с повторяющимся содержимым. Выход: упростить таблицу до плоской.
- Сноски и примечания: Markdown-сноски
[^1]Pandoc превращает в<footnote>FB2, но Calibre их теряет. Онлайн-конвертер частично сохраняет. - Изображения: в FB2 картинки вкладываются в виде Base64-данных внутри архива. Если в Markdown ссылка на внешний URL, конвертер её не скачает — нужно сначала локально сохранить и указать правильный
--resource-path. - Кодировка: файлы в Windows-1251 (старые документы) при конвертации через Pandoc без флага
--from markdown+smartмогут дать кракозябры. - Спецсимволы: символ
<в тексте должен быть экранирован как<— Pandoc делает это автоматически, а онлайн-конвертер может пропустить.
Как отлаживать: конвертируйте небольшой фрагмент (10 строк) и открывайте FB2 в блокноте — смотрите структуру XML. Если теги не закрыты или порядок нарушен — читалка не откроет файл.
7. Частые ошибки и их решение
- Ошибка: «После конвертации весь текст слипся в одну строку». Причина — отсутствие перевода строк в Markdown. Решение: проверьте, что каждый абзац отделён пустой строкой. Pandoc интерпретирует строки без пробела как один параграф.
- Ошибка: «Список отображается как обычный текст». Проверьте, что перед элементами списка стоит пробел после маркера (
- текст), а не табуляция. В FB2 списки требуют<list>с<li>внутри. Calibre часто ошибается с отступами. - Ошибка: «Изображения не показываются». FB2 не поддерживает внешние ссылки на картинки. Решение: в Markdown вставляйте изображения через
и конвертируйте через Pandoc с флагом--extract-media=./— он встроит их в FB2. - Ошибка: «FB2 не открывается в читалке». Часто — из-за невалидного XML. Проверьте через
xmlstarlet val book.fb2или просто откройте в браузере — он покажет ошибку. Исправляйте вручную или конвертируйте заново.
Совет: всегда конвертируйте из Markdown, написанного строго по спецификации CommonMark (например, через редактор Typora). Тогда исходный код будет разобран однозначно.
8. Альтернативы: когда FB2 не подходит
FB2 — формат для русскоязычных читалок (особенно PocketBook). Но если ваша целевая аудитория использует Kindle или iPhone, лучше выбрать EPUB или MOBI. Вот чем заменить:
- Для Amazon Kindle: конвертируйте Markdown в EPUB через Markdown в EPUB, затем в MOBI через Calibre.
- Для универсальности: EPUB — стандарт индустрии, его читают все приложения (кроме старых Kindle).
- Если исходник в DOCX: сначала преобразуйте в Markdown через DOCX в Markdown, а потом в нужный формат.
- Если нужно из FB2 вернуться в Markdown: используйте FB2 в Markdown.
Итог: выбирайте формат по устройству читателя. Для максимальной совместимости — EPUB. Но если заказчик требует FB2 — Pandoc или наш онлайн-конвертер справятся на 90%+.
🧮 Посчитайте сами — инструменты по теме
🧭 Разделы по теме
Частые вопросы
Как конвертировать Markdown в FB2 через онлайн-конвертер?
Зайдите на страницу Markdown в FB2, загрузите файл .md или вставьте текст и нажмите «Конвертировать». Через несколько секунд скачайте готовый FB2.
Какой конвертер Markdown в FB2 лучший?
Для гибкости и контроля – Pandoc. Для простоты и скорости – наш онлайн-конвертер. Calibre – если вы уже пользуетесь его библиотекой.
Можно ли конвертировать Markdown в FB2 с изображениями?
Да, но только если изображения локальные. Pandoc встраивает их в FB2 как бинарные данные. Онлайн-конвертер вставляет заглушки.
Почему после конвертации пропали таблицы?
Вероятно, таблица содержит объединённые ячейки (colspan/rowspan). FB2 не поддерживает такое. Упростите таблицу или перепишите её без объединений.
Как конвертировать FB2 обратно в Markdown?
Используйте FB2 в Markdown – обратный конвертер на нашем сайте, или Pandoc с командой pandoc input.fb2 -o output.md.
Как добавить обложку в FB2 при конвертации?
Pandoc поддерживает обложку через метаданные, но не сразу — нужно указать изображение как cover-image. В онлайн-конвертере обложка не добавляется.
Почему FB2 не открывается на Kindle?
Kindle нативно не поддерживает FB2. Конвертируйте сначала в MOBI через Calibre, или используйте Markdown в EPUB, затем в MOBI.
Как сохранить сноски при конвертации в FB2?
Используйте Pandoc – он корректно преобразует Markdown-сноски [^1] в FB2. Calibre сноски теряет.
Источники и нормативные документы
- Pandoc – документация по выходным форматам
- Спецификация FictionBook 2.2
- Markdown CommonSpec
- MDN: Основы XML