Миссия
Миссия
Сделать чистый PDF из Markdown доступным каждому, у кого есть браузер, без учётной записи, подписки и загрузки. Сохранить конвертацию понятной: человек должен видеть документ, выбирать тему и точно знать, что будет напечатано.
О md2pdf
История
md2pdf начался с знакомой проблемы: документация удобно читается на экране, но рассыпается, как только её нужно отправить, заархивировать или напечатать.
Markdown переносим, пока получателю не нужен PDF. Диалог печати браузера сохраняет страницу, а не документ: в него попадает навигация, ломаются относительные изображения, широкие блоки кода обрезаются, а таблицы разрываются в неудобных местах. Настольные конвертеры решают часть этого, но обычно требуют установки, учётной записи или загрузки на сервер.
md2pdf выбирает более узкий путь. Он читает Markdown, разрешает пути относительно репозитория, отрисовывает Markdown в стиле GitHub в браузере, очищает результат, применяет стили печати и передаёт документ встроенному PDF-движку браузера. Исходник не покидает устройство, если только пользователь не попросит загрузить публичный README.
Видение
Видение
Веб, в котором обычным документам не нужны проприетарное настольное приложение или сервис конвертации, чтобы стать переносимыми. Markdown уже читаем, сравним и долговечен; PDF должен быть честным выходом, а не вторым хранилищем.
Создатель
Girish Lade
Создатель md2pdf · LadeStack
Girish Lade разрабатывает md2pdf в LadeStack. Он работает над конвертером, темами печати, сценарием книги документации и локализованными версиями этого сайта.
Проект намеренно небольшой и самодостаточный: статический фронтенд на Astro, код конвертации только для браузера и набор тестов, который проверяет результат, а не обещает его.
Место для портрета на этой странице зарезервировано для подлинной фотографии. Пока её нет, компонент показывает фирменный монограмм, а не сгенерированное или стоковое изображение.
Как устроен продукт
Как устроен продукт
Сначала браузер
Разбор Markdown, очистка, создание оглавления, печатная вёрстка и сборка PDF выполняются на устройстве посетителя. Сайт статический; серверного приложения нет.
Небольшие явные лимиты
Один файл — до 2 МБ. Книга документации вмещает до 30 файлов Markdown, по 750 КБ на файл, 6 МБ всего, с ограниченным числом запросов к API.
Вывод — печать
Итоговый PDF создаёт встроенный движок печати браузера. md2pdf передаёт очищенный документ и стили печати и не притворяется движком рендеринга PDF.
Девять языков
Интерфейс, руководства и эта страница опубликованы на английском, испанском, японском, корейском, упрощённом китайском, русском, турецком, французском и бразильском португальском.
Достижения без прикрас
Достижения без прикрас
Это уже выпущенные возможности, а не обещания из плана.
- Импорт публичных README с GitHub с определением ветки по умолчанию и переписыванием относительных изображений и ссылок.
- Сценарии вставки, загрузки и примера для Markdown, включая таблицы в стиле GitHub, списки задач и блоки кода.
- Четыре темы печати: Clean, Business, Academic и Dark.
- Автоматическое оглавление для документов с тремя и более заголовками.
- Книга документации из нескольких файлов с обложкой, упорядоченными главами, поиском по выбору и изоляцией печати.
- Экспорт PDF по главам и ZIP-архивы с ограничениями по размеру и числу файлов.
- Девять локализованных версий интерфейса, статей и этой страницы.
- Без учётной записи, без загрузки локального или вставленного Markdown и без серверного рендерера.
Для кого
Для кого
md2pdf полезен, когда документ важнее инструментов.
Студенты и преподаватели
Превращайте конспекты, задания и материалы для чтения в PDF, который можно сдать или напечатать.
Разработчики и технические писатели
Экспортируйте README, RFC или главы документации, не устанавливая конвертер.
Консультанты и небольшие команды
Передавайте клиенту аккуратный документ, не отправляя Markdown стороннему сервису.
Архивисты
Сохраняйте читаемую постраничную копию документации, которая может измениться или исчезнуть у источника.
Приватность
Локальные файлы и вставленный Markdown читаются в браузере и не загружаются. При получении публичного GitHub-репозитория отправляются анонимные запросы к GitHub за README и изображениями; приватные репозитории не поддерживаются. Учётных записей нет, аналитика конвертации к документу не привязана.
Доступность
Страницы используют смысловые ориентиры, подписанные элементы управления, видимый фокус и переключатель языка, сохраняющий текущий путь. Анимация ограничена и учитывает предпочтение уменьшенного движения. Стили печати удерживают заголовки с содержимым и по возможности не разрывают блоки кода, таблицы и изображения между страницами. Доступность — постоянная работа, а не разовое заявление.
Права
Права
md2pdf — продукт LadeStack. LadeStack владеет названием продукта, сайтом и опубликованными версиями. Репозиторий с исходным кодом открыт на github.com/girishlade111/ReadmePDF; репозиторий сохраняет первоначальное имя, хотя продукт называется md2pdf. md2pdf можно использовать бесплатно.
Контакты
Контакты
Вопросы, исправления и сообщения о доступности приветствуются. Надёжнее всего электронная почта; issues на GitHub публичны и доступны для поиска.
- Почта admin@ladestack.in
- GitHub github.com/girishlade111
- LinkedIn linkedin.com/in/girish-lade
- LadeStack ladestack.in
Документ на входе, PDF на выходе.
Без учётной записи. Локальные файлы не загружаются. Начните с примера, вставьте свой Markdown или загрузите публичный README.