Вопросы и ответы
Ответы на частые вопросы о MarkPDF
Какой синтаксис Markdown поддерживается?
MarkPDF поддерживает синтаксис CommonMark: заголовки, абзацы, выделение, списки, ссылки, изображения, блоки кода, цитаты и горизонтальные линии, а также таблицы в стиле GitHub, зачёркивание и автоссылки. Формулы пишутся в $ … $ и $$ … $$.
Текстовый PDF или PDF-изображение: в чём разница?
Есть два способа экспорта. «Скачать PDF (текст)» использует движок печати браузера: текст можно выделять и искать, ссылки работают, файл небольшой; в окне печати выберите «Сохранить как PDF». «Быстро скачать (изображение)» сохраняет страницы как картинки одним кликом (около 180 DPI на A4): выглядит точно как предпросмотр, но текст нельзя выделить, и его не найдут ни поиск, ни системы отбора резюме (ATS). Во встроенных браузерах приложений (Telegram, VK, Instagram…) печать может быть недоступна, поэтому там первым предлагается вариант-изображение.
Поддерживаются ли формулы и подсветка кода?
Да. Блоки кода подсвечиваются с помощью highlight.js (более 190 языков), а формулы в $ … $, $$ … $$, \( … \) или \[ … \] отображаются через KaTeX.
Есть ли ограничение на размер файла?
Вся обработка идёт в браузере, поэтому реальный предел зависит от вашего устройства. Файлы Markdown в несколько десятков КБ (десятки тысяч слов) обычно обрабатываются без проблем. Очень большие документы могут отображаться дольше.
Как выбрать подходящий шрифт?
Для русского текста подходит шрифт по умолчанию, а шрифты для арабского, хинди и других письменностей подгружаются автоматически. Для упрощённого китайского выберите Noto Sans SC или Source Han Sans, для традиционного — Noto Sans TC, для японского — Noto Sans JP, для корейского — Noto Sans KR. Для документов на нескольких языках лучше всего Source Han Sans.
Насколько быстро идёт конвертация?
Скорость зависит от длины и сложности документа. Обычная статья на 2000 слов конвертируется за 2–3 секунды. Длинным документам с большим количеством таблиц и кода может понадобиться 5–10 секунд. Всё происходит локально в браузере, без передачи по сети.
Вы сохраняете мои документы?
Нет. Вся обработка в MarkPDF идёт локально в браузере, содержимое документа никогда не отправляется на наши серверы. Именно ради конфиденциальности мы выбрали отрисовку в браузере.
Можно ли конвертировать несколько файлов сразу?
Текущая версия конвертирует по одному документу. Пакетной конвертации пока нет.
Можно ли настроить оформление PDF?
В панели настроек можно выбрать шрифт, размер шрифта, формат бумаги (A4, Letter, A5) и поля; выбор запоминается на этом устройстве. Собственный CSS и колонтитулы пока недоступны.
Есть ли API?
Пока API нет. MarkPDF целиком работает в браузере. Если нужно встроить создание PDF в своё приложение, посмотрите на открытые библиотеки, которые мы используем (markdown-it + html2pdf.js).
Какие браузеры поддерживаются?
MarkPDF работает во всех современных браузерах: Chrome 80+, Firefox 75+, Safari 14+, Edge 80+. Для лучшего результата используйте свежую версию Chrome или Edge. Internet Explorer не поддерживается.
Можно ли пользоваться с телефона?
Да. Интерфейс адаптирован для телефонов и планшетов. На маленьком экране редактор и предпросмотр располагаются друг под другом; переключайтесь между ними кнопкой «Предпросмотр».
Можно ли вставлять изображения?
Да. Используйте обычный синтаксис изображений Markdown для картинок из интернета. Загрузка изображений с устройства пока не поддерживается: сначала загрузите картинку на фотохостинг, а затем используйте её ссылку.
Можно ли экспортировать в другие форматы?
Сейчас основной формат — PDF. Экспорт в HTML в разработке, другие форматы, например Word (.docx), возможно, появятся в следующих версиях.
Где получить помощь?
MarkPDF не предоставляет индивидуальную поддержку. Ответы на большинство вопросов есть на этой странице, в инструкции и в руководствах по решению проблем, где подробно разобраны шрифты, кодировки и вёрстка.