${ctx.sanitizeInline(String(data.text ?? ''))}
`, }, }); ``` ### blocksToPlainText(data, options?) string Извлечь простой текст сохранённого документа — блоки разделяются \n\n, элементы списка — \n, ячейки таблицы — \t. Синхронно и без DOM, те же опции, что у blocksToHtml, плюс includeHiddenText. Идеально для превью, поисковой индексации и подсчёта символов. Когда использовать В ядре нет хелпера «размер документа», потому что два размера, которые можно иметь в виду, измеряются по-разному: `blocksToPlainText(data).length` — это длина видимого содержимого (то, что напечатал пользователь), а `new TextEncoder().encode(JSON.stringify(data)).length` — размер при передаче в байтах (то, что должен проверять лимит сохранения или загрузки — например, 500KB). Используйте длину простого текста для правил по содержимому, а длину JSON в байтах — для правил по хранению. Параметры | Параметр | Тип | Обязательный | По умолчанию | Описание | | --- | --- | --- | --- | --- | | `data` | `OutputData | LooseOutputData | null | undefined` | Обязательный | — | Сохранённый документ в строгом формате save() или в нестрогом формате передачи. | | `options.includeHiddenText` | `boolean` | — | — | Читать также медиатекст, который вывод по умолчанию опускает, потому что редактор рисует его как атрибут или не рисует вовсе: alt изображения, url видео или файла, source встраивания, title, artist и url аудиодорожки, description и url закладки. Каждое значение добавляется после видимой подписи блока, по одному в строке. По умолчанию выключено, поэтому стандартный вывод остаётся ровно тем, что читатель видит на экране, — включайте опцию для поискового индекса, где люди ищут и alt-текст, и вставленный URL. | TypeScript ``` import { blocksToPlainText } from '@bloklabs/core/view'; // A 160-character preview for a card or meta description const preview = blocksToPlainText(savedData).slice(0, 160); // Content length (characters the user typed) vs transport size (bytes on the wire) const contentLength = blocksToPlainText(savedData).length; const transportBytes = new TextEncoder().encode(JSON.stringify(savedData)).length; if (transportBytes > 500 * 1024) { throw new Error('Document exceeds the 500KB save limit'); } ``` ### blocksToMarkdown(data) string Сериализовать сохранённый документ в Markdown — синхронно и без DOM, исходящий близнец markdownToBlocks. Заголовки становятся #, списки — -/1., задачи — - [x], таблицы — сетками из вертикальных черт в стиле GFM. В Markdown нет выноски, тоггла, колонки и отступа, поэтому выноска становится цитатой с её эмодзи, тоггл — жирной строкой-сводкой, за которой идёт его тело, колонки схлопываются в порядок чтения, а отступ отбрасывается. Возвращает '' для пустых или некорректных документов. TypeScript ``` import { blocksToMarkdown } from '@bloklabs/core/view'; // Feed an article to an LLM, or write it to a .md file const markdown = blocksToMarkdown(savedData); ``` ### blocksToMarkdownWithReport(data) { markdown: string; warnings: MarkdownDegradation[] } Тот же Markdown плюс список того, что не удалось перенести: каждая запись называет конструкцию, было ли это 'dropped' (ничего не выведено) или 'degraded' (выведено с потерями), и почему. Берите его, когда результат уходит туда, где нельзя задать уточняющий вопрос, — в AI-клиент, в экспорт — и где нужно сообщить, чего не хватает. Блок, который не даёт вывода и не несёт строчного текста, тоже попадает в отчёт, поэтому собственный инструмент без формы в Markdown называется по имени, а не исчезает. TypeScript ``` import { blocksToMarkdownWithReport } from '@bloklabs/core/view'; const { markdown, warnings } = blocksToMarkdownWithReport(savedData); // warnings: [{ construct: 'callout', action: 'degraded', detail: 'callout is rendered as a blockquote; …' }] ``` ### htmlTextContent(html) string Извлечь простой текст HTML-фрагмента — синхронно и без DOM, замена element.textContent в View-рендерере. Сущности декодируются (`a < b` → `a < b`), а `