Documentize — полное руководство
Пять вечера. Отчёт на 90 страниц должен уйти клиенту сегодня, а почта только что вернула его: файл слишком велик. Эта книга показывает, как решить такое за несколько кликов и как перестать бояться следующего раза.
Сайт вы, скорее всего, уже видели: products.documentize.app и products.documentize.ai. Каждая страница там хорошо делает одну небольшую задачу. Книга рассказывает, что делает каждая страница, чего она не делает и как соединять страницы в цепочки, чтобы довести дело до конца: отправить тяжёлый отчёт по почте, превратить фото с телефона в PDF с поиском, разобраться в исследовании на 90 страниц до завтрашней встречи. Она честно говорит о пробелах и старается читаться с удовольствием.
Начните отсюда, что бы вам ни было нужно
- У меня задача прямо сейчас → откройте поиск по цели или сразу рецепт, например отправить большой отчёт по почте.
- Хочу знать все инструменты → прочитайте часть I, затем основные понятия, затем своё семейство приложений.
- Хочу автоматизировать → переходите к разделу «За пределами браузера», но сначала пройдите один рецепт вручную.
Как устроена книга
- Видение → почему много небольших приложений лучше одного гигантского редактора (часть I)
- Понятия → семь идей, общих для всех приложений (часть II)
- Карта → как приложения связаны друг с другом (часть III)
- Приложения → по странице на приложение, один шаблон, группировка по задаче (части IV–XI)
- Рецепты → цепочки приложений под конкретную цель (часть XII)
- За пределами браузера → CLI, MCP, API, собственный сервер (часть XIII)
- Помощь и справочник (части XIV–XV)
Любой путь заканчивается картой из части III, так что можно всегда «отъехать» и увидеть картину целиком.
Структура файлов: одна запись — один файл; папка = глава; index.md = стартовая страница главы.
Часть I — Видение: зачем нужен Documentize
01-vision/
- I.1 Проблема: документы — это куча мелких дел
- Обычный день: объединить, сжать, разблокировать, распознать, подписать, конвертировать, разобраться
- Почему один большой редактор — неверный ответ и почему много небольших узких приложений — верный
- I.2 Идея Documentize: одно приложение — одна задача
- Открыли, перетащили файл, получили результат — без установки и без обязательной учётной записи
- Каждое приложение делает что-то одно, и делает это хорошо; результат передаётся следующему приложению
- I.3 Два сайта, одно семейство продуктов
- products.documentize.app — классические инструменты для PDF
- products.documentize.ai — ИИ-инструменты (понять, создать, дополнить)
- Какой сайт открыть под какую задачу (таблица выбора)
- I.4 Для кого эта книга и как её читать
- Путь A «У меня задача» → рецепты части VIII
- Путь B «Хочу знать каждый инструмент» → части IV–XI
- Путь C «Хочу автоматизировать» → часть IX
- I.5 Портфель продуктов одним взглядом
- Все ~50 приложений на одной странице, по группам (составлено по карте из части III)
Часть II — Основные понятия, общие для всех приложений
02-concepts/
- II.1 Универсальный сценарий: Загрузка → Параметры → Запуск → Результат
- Устройство страницы приложения (зона загрузки, панель параметров, кнопка запуска, панель результата)
- Способы загрузки: перетаскивание, выбор файла, несколько файлов, URL/облако там, где они предусмотрены
- Страница результата: скачивание, предпросмотр, ссылка для общего доступа, «открыть в другом приложении»
- II.2 Что такое «документ»: форматы и типы файлов
- PDF (текстовый, отсканированный, только из изображений), DOCX, изображения, HTML, SVG, архивы, EPUB/MOBI/TXT
- Какие форматы принимает и выдаёт каждое приложение (матрица → Приложение A)
- II.3 Задачи, параметры и результаты
- Обязательные и необязательные параметры, разумные значения по умолчанию, «что изменится, если я поменяю это»
- Имена выходных файлов и что происходит с вашим оригиналом (он никогда не изменяется)
- II.4 Лимиты, тарифы и дневная квота
- Размер файла, число страниц, лимит времени на задачу, дневное число операций
- Продолжение обработки: как закончить частично обработанную пачку в другой день, бесплатно
- Анонимное и авторизованное использование
- II.5 Конфиденциальность и жизненный цикл данных
- Где обрабатываются файлы, сколько они хранятся, автоматическое удаление
- Что ИИ-приложения отправляют моделям, а что — нет
- Документы с паролем и конфиденциальные документы: правила безопасного обращения
- II.6 Язык и локализация
- Язык интерфейса и язык документа (OCR, перевод, вывод ИИ)
- II.7 Модель качества: «без потерь», «с потерями», «сгенерировано заново»
- Какие приложения оставляют содержимое нетронутым, какие переписывают его, а какие придумывают новое (ИИ)
- Почему это важно для порядка шагов в цепочке
Часть III — Карта: как связаны приложения
03-map/
- III.1 Семейное древо приложений
- Восемь семейств: Организация · Структура и дополнения · Защита и подтверждение · Сжатие и восстановление · Извлечение и поиск · Конвертация и создание · Понимание с помощью ИИ · ИИ для разработчиков
- III.2 Модель конвейера: вход → состояние → выход
- У каждого документа есть состояние (скан? заблокирован? большой? есть закладки? есть текстовый слой?)
- Каждому приложению нужно определённое состояние, и каждое его меняет
- III.3 Матрица зависимостей приложений: «нужно», «улучшает», «ломает»
- Примеры строк: OCR → поиск по тексту → поиск; выравнивание наклона → OCR; разблокировка → почти всё; сжимать в конце, подписывать в конце
- III.4 Золотые правила порядка
- Сначала починить, потом анализировать · Исправить ориентацию до OCR · Редактировать до подписи · Сжимать после правок · Защищать в последнюю очередь
- Антипаттерны (что молча уничтожает подписи, текстовые слои и закладки)
- III.5 Похожие приложения: какое выбрать?
- Сжатие PDF и Оптимизировать PDF · PDF с возможностью поиска, Изображение в TXT и Извлечь текст · Добавить содержание в PDF и Оглавление AI
- Уплощение PDF и Протектор PDF · Удалить страницы и Разделение PDF · Изменить размер PDF и Сжатие PDF · Парсер PDF и Извлечение данных формы
- Подпись и проверка подписи
- III.6 Поиск приложения по цели
- Справочник «Я хочу… → используйте…» (удобно искать, одна строка на цель)
Часть IV — Организация: страницы, файлы, макет
04-organize/ · обзор семейства
Страницы на входе, страницы на выходе. Эти приложения работают без потерь и обычно стоят в начале или в конце цепочки.
- IV.1 Объединение файлов (Merger) — собрать много файлов в один PDF
- IV.2 Разделение PDF (Splitter) — разрезать один PDF на несколько (по страницам, диапазонам, размеру, закладкам)
- IV.3 Удалить страницы (Delete Page) — убрать ненужные страницы
- IV.4 Ротация PDF (Rotation) — исправить ориентацию страниц (все, нечётные/чётные, выбранные)
- IV.5 Изменить размер PDF (Resize) — поменять размер страницы (A4/Letter/произвольный), масштабирование или вписывание
- IV.6 Создатель буклетов (Booklet) — переставить страницы для печати сложенных брошюр
- IV.7 Практикум по главе: привести в порядок пачку неаккуратных сканов
- IV.8 Как приложения семейства работают вместе
Часть V — Структура и дополнения: сделать документ удобным для навигации и богаче
05-add-structure/ · обзор семейства
- V.1 Добавить содержание в PDF (Add TOC) — построить кликабельное оглавление по заданным вами правилам
- V.2 Оглавление AI (Table of Contents AI) — автоматически найти заголовки и иерархию
- Добавить содержание в PDF и Оглавление AI: контроль или автоматизация
- V.3 Добавить таблицу в PDF (Add Table) — вставить в страницы таблицы с вашими данными
- V.4 Уплощение PDF (Flatten) — «запечь» формы, аннотации и слои в страницу
- V.5 Collage — собрать изображения/страницы на одном листе с ИИ-раскладкой
- V.6 AI Illustrator — создать иллюстрации к сценам вашего текста
- V.7 Практикум по главе: от сырой рукописи до PDF с навигацией и иллюстрациями
- V.8 Как приложения семейства работают вместе
Часть VI — Защита и подтверждение
06-protect/ · обзор семейства
- VI.1 Протектор PDF (Protector) — закрыть PDF паролем (один пароль на открытие; что он ограничивает, а что нет)
- VI.2 Разблокировка PDF (Unlock) — снять пароль, который вы знаете (в вебе: PDF; файлы Office — через плагин CLI)
- VI.3 Цифровая подпись PDF (Sign) — добавить цифровую/электронную подпись
- VI.4 Проверка подписи (Verify Signature) — убедиться, что подписи целы (режим страницы «Подпись»)
- VI.5 PDF/A Validator — проверка на соответствие архивному стандарту; что означают ошибки
- VI.6 PDF Redactor — пока недоступно: что делать вместо этого
- VI.7 Compare PDFs — пока недоступно: как сравнить две версии вручную
- VI.8 Практикум по главе: подготовить договор к отправке наружу
- VI.9 Как приложения семейства работают вместе
- Порядок, при котором подписи остаются действительными: правка → уплощение → сжатие → защита → подпись
Часть VII — Сжатие, очистка и восстановление
07-shrink-repair/ · обзор семейства
- VII.1 Сжатие PDF (Compressor) — уменьшить размер файла для почты/загрузки (уровни качества)
- VII.2 Оптимизировать PDF (Optimize) — наведение порядка на уровне структуры (быстрый веб-просмотр, дубликаты, шрифты)
- VII.3 Deskew — выровнять наклонённые сканы
- VII.4 Recovery — спасти повреждённые или частично читаемые PDF
- VII.5 Unwatermark — убрать водяные знаки (и когда это не сработает)
- VII.6 Практикум по главе: превратить скан с телефона на 200 МБ в ровный читаемый PDF на 5 МБ
- VII.7 Как приложения семейства работают вместе
Часть VIII — Извлечение, чтение и поиск
08-extract/ · обзор семейства
- VIII.1 Изображение в TXT (OCR Image) — текст из фотографий и сканов
- VIII.2 PDF с возможностью поиска (Searchable) — добавить невидимый текстовый слой в отсканированный PDF
- VIII.3 Извлечь текст (Extract Text) — получить простой текст (с раскладкой или без неё)
- VIII.4 Извлечение изображений (Extract Image) — вытащить встроенные картинки
- VIII.5 Извлечение метаданных (Extract Metadata) — автор, даты, программа-производитель, пользовательские свойства
- VIII.6 Извлечение данных формы (Extract Form Data) — имена и значения полей заполненных форм
- VIII.7 Парсер PDF (Parser) — разобрать PDF на текст, изображения, вложения, закладки, аннотации и данные форм
- VIII.8 Поиск в PDF (Search) — найти текст внутри PDF · Global Search — поле поиска по всему сайту (это не поиск по документу)
- VIII.9 Resume Analyzer — извлечь данные и оценить резюме по отношению к вакансии
- VIII.10 Практикум по главе: превратить стопку сканов в архив, по которому можно искать и задавать вопросы
- VIII.11 Как приложения семейства работают вместе
Часть IX — Конвертация и создание
09-convert-create/ · обзор семейства
- IX.1 Конвертер (Converter) — PDF ↔ Word, HTML, изображения и другие форматы; что сохраняет каждый целевой формат
- IX.2 SVG Maker — многослойная векторная графика по текстовому описанию, с помощью ИИ
- IX.3 Chat (создать PDF в чате) — опишите документ и получите его
- IX.4 Практикум по главе: от идеи до иллюстрированного PDF с оглавлением
- IX.5 Как приложения семейства работают вместе
Часть X — Понимать с помощью ИИ
10-ai-understand/ · обзор семейства
ИИ-приложения читают ваше содержимое и создают новое. Относитесь к результатам как к черновикам. См. II.7.
- X.1 Ask PDF / чат с PDF — ответы на вопросы по одному документу с опорой на текст
- X.2 PDF Knowledge Base — вопросы сразу по многим документам
- X.3 Abstracts Generator — академическая / техническая / деловая / информативная / описательная аннотация
- X.4 Cheat Sheet — шпаргалка на одной странице
- X.5 Checklist — Задачи / Обучение / Подготовка / Анализ × четыре уровня детализации
- X.6 Как формулировать запросы и параметры для ИИ-приложений
- X.7 Доверие, проверка и пределы ответов ИИ
- X.8 Практикум по главе: усвоить отчёт на 300 страниц за 30 минут
Часть XI — ИИ для разработчиков и команд
11-ai-dev/ · обзор семейства
Для тех, кто работает с кодом, репозиториями и релизами.
- XI.1 Assembly Chat — вопросы к публичному API сборки .NET
- XI.2 Code Graph — увидеть, как устроен репозиторий
- XI.3 Repo Docs — сгенерировать документацию по репозиторию
- XI.4 Release Notes — выведено из эксплуатации; что использовать вместо него
- XI.5 Refactor Assistant
- XI.6 NuGet Updater
- XI.7 Fork Sync — выведено из эксплуатации; что использовать вместо него
- XI.8 Page SEO Checker
- XI.9 Advisor · Document Engineer (и выведенный из эксплуатации Personal Engineer)
Часть XII — Рецепты: достигаем целей цепочками приложений
12-recipes/ · как читать рецепт
Все рецепты построены по одному шаблону: Цель → Исходное состояние → Цепочка (схема) → Пошагово, с параметрами → Ожидаемый результат → Проверка → Варианты → Что может пойти не так.
XII.A Повседневная офисная работа
- Отправить большой отчёт по почте — Удалить страницы → Оптимизировать PDF → Сжатие PDF
- Собрать один пакет документов для подачи из многих файлов — Конвертер → Ротация PDF → Изменить размер PDF → Объединение файлов → Добавить содержание в PDF → Сжатие PDF
- Подготовить PDF-форму, которую заполняют и возвращают, безопасной — Извлечение данных формы → Уплощение PDF → Протектор PDF
- Поделиться только частью документа — Разделение PDF / Удалить страницы → Протектор PDF
XII.B Сканы и архивы
- Фотографии с телефона — в чистый PDF с поиском — Конвертер (изображения→PDF) → Deskew → Ротация PDF → PDF с возможностью поиска → Сжатие PDF
- Оцифровать бумажный архив — Deskew → PDF с возможностью поиска → Извлечение метаданных → PDF/A Validator → PDF KB
- Восстановить и использовать содержимое повреждённого файла — Recovery → Разблокировка PDF → Извлечь текст / Извлечение изображений
XII.C Договоры, юридические вопросы и соответствие требованиям
- Круговой обмен договором — сравнение через Извлечь текст → Уплощение PDF → Цифровая подпись PDF → Проверка подписи
- Поставка, готовая к архиву (PDF/A) — Уплощение PDF → Оптимизировать PDF → PDF/A Validator
- Чек-лист безопасной передачи наружу — Извлечение метаданных (осмотр) → Удалить страницы → Recovery (полная санитизация) → Протектор PDF
XII.D Издание и печать
- Напечатать сложенную брошюру — Изменить размер PDF → Создатель буклетов
- Превратить рукопись в иллюстрированную электронную книгу — Chat/Конвертер → Оглавление AI → Illustrator → Добавить содержание в PDF → Сжатие PDF
- Сделать плакат/лист-коллаж — Извлечение изображений → Collage → Изменить размер PDF
XII.E Работа со знаниями
- Быстро разобраться в длинном документе — PDF с возможностью поиска (если это скан) → Abstracts → Cheat Sheet → Ask PDF
- Превратить спецификацию в план действий — Ask PDF → Checklist
- Отобрать кандидатов — Resume (оценить каждое резюме) → сравнить оценки
- Построить базу знаний команды — PDF с возможностью поиска → Объединение файлов → PDF KB
XII.F Извлечение данных
- Таблицы и формы — в электронную таблицу — Парсер PDF / Извлечение данных формы → Конвертер
- Собрать все изображения и тексты из брошюры
XII.G Проектируем собственную цепочку
- Рабочий лист для построения рецепта: определить цель, проверить состояние, выбрать приложения, порядок, проверку
- Повторять цепочку каждый день: вручную → CLI → MCP/API
Часть XIII — За пределами браузера
13-beyond-browser/
- XIII.1 Какой канал когда: веб-приложение, CLI, MCP, API или собственный сервер
- XIII.2 Плагины Documentize CLI
- Установка, одна команда на приложение, цепочки через конвейеры оболочки и скрипты
- XIII.3 Сервер MCP: используйте Documentize в Claude, Cursor, VS Code
- Настройка клиента, список инструментов, примеры диалогов, выполняющих цепочку
- XIII.4 REST API
- Ключи, загрузка, асинхронные задачи, опрос состояния, скачивание результатов, продолжение обработки
- XIII.5 Self-Host — те же приложения на вашем собственном сервере для закрытых данных
- XIII.6 Desktop
- XIII.7 Documentize.Plugins для разработчиков
- XIII.8 Библиотека практических руководств — одна и та же операция в вебе, CLI и MCP рядом
Часть XIV — Когда что-то пошло не так
14-troubleshooting/
- XIV.1 Блок-схема диагностики: найдите симптом, найдите страницу
- XIV.2 Проблемы с загрузкой — размер, тип, пароль, повреждённый файл
- XIV.3 «Результат выглядит неправильно» — шрифты, пропавший текст, потерянные закладки, сломанные формы
- XIV.4 «Остановилось на полпути» — лимит времени, дневная квота, продолжение обработки
- XIV.5 Проблемы с подписями, паролями и правами доступа
- XIV.6 Проблемы с качеством OCR и ИИ
- XIV.7 Как получить помощь: что указать в обращении в поддержку
Часть XV — Справочник и приложения
15-appendices/
- A. Матрица форматов: приложение × вход/выход
- B. Словарь параметров: каждое имя параметра, значение и типичные значения
- C. Шпаргалки по приложениям — по одной печатной карточке на приложение
- D. Матрица зависимостей (полная)
- E. Глоссарий — OCR, PDF/A, текстовый слой, уплощение, редактирование (redact), закладки, выравнивание наклона, DPI, RAG, MCP…
- F. Таблица лимитов и тарифов
- G. Частые вопросы
- H. Условия, лицензирование и благодарности
- I. Что нового / дорожная карта
- J. Указатель приложений (А–Я) и указатель целей
Шаблон страницы каждого приложения (части IV–XI)
Заголовки везде одинаковые, чтобы читатель освоил схему один раз.
- Одним предложением — что делает приложение
- Чем оно уникально — что не умеет ни одно другое приложение Documentize
- Когда использовать и когда нет — и какое приложение лучше в этом случае
- Прежде чем начать — требуемое состояние документа (скан? заблокирован? размер?)
- Пошагово — с заглушками под скриншоты
- Параметры подробно — каждый параметр, его действие, значение по умолчанию, рекомендуемое значение
- Что вы получаете — формат результата, имена файлов, что изменилось по сравнению с оригиналом
- Качество и лимиты — без потерь / с потерями / создано ИИ; ограничения по размеру и времени
- Хорошо работает с — использовать до / использовать после (ссылки на соседей и на рецепты)
- Типичные ошибки и их исправление
- То же самое в других местах — команда CLI, инструмент MCP, вызов API
- Попробуйте — упражнение на 5 минут с тестовым файлом
Заметки для авторов
- Названия, параметры и лимиты нужно сверять с работающими приложениями перед окончательной редакцией каждой главы.
- Часть III (карта) и Приложение D должны оставаться согласованными — это опора всей книги.
- Страница каждого приложения ссылается вверх на обзор своего семейства и в стороны как минимум на двух соседей и один рецепт.