pagecraft-markdown-block

⚡ Этот скилл — для вызова через тул Skill(pagecraft-markdown-block), не через Read .../SKILL.md. Если ты сюда попал через Read — остановись, вызови Skill(pagecraft-markdown-block). Содержимое то же, но система правильно учтёт делегирование.

PageCraft Markdown Block

Альтернатива schema-блоку (pagecraft-schema-block). Различие в том, где живёт основной контент:

• schema-блок: контент в полях схемы (props.title, props.subtitle, props.button.text, …). Редактор заполняет формочки.
• markdown-блок: основной текст в markdown-редакторе (WYSIWYG). В шаблоне он доступен как {{ content }} — уже отрендеренный HTML, без префикса. Схема описывает только обвес: размер, тему, цвета, отступы.

Формат: _markdown — это GFM (GitHub Flavored Markdown). Поддерживаются таблицы, strikethrough ~~text~~, autolinks, картинки. На сервере рендерится через league/commonmark + TableExtension. Это значит, что в шаблоне {{ content }} могут появиться теги table/thead/tbody/tr/th/td/del — их обязательно стилизовать в CSS.

Использовать markdown-блок, когда:

• контент длинный, форматированный (заголовки, списки, цитаты, code-блоки, таблицы)
• блок похож на «статью» или «справочный раздел»
• редактору удобнее писать в markdown-редакторе, а не заполнять кучу полей

Структура блока

blocks/{slug}/
├── block.json       — метаданные. block_type: "markdown"
├── schema.json      — настройки оформления (размер, тема, ширина)
├── template.liquid  — шаблон. Содержит {{ content }} без префикса
├── style.css        — стили + типографика для h1–h6, p, a, ul, ol, blockquote, code, pre, table
├── preview.html     — превью
└── doc.md

В block.json обязательно:

{ "block_type": "markdown", ... }

Шаблон

<div class="{author}-{slug} {author}-{slug}--{{ props.theme }}">
  <div class="{author}-{slug}__content">
    {{ content }}
  </div>
</div>

{{ content }} — это готовый HTML, не markdown. Экранирование запрещено. Любые попытки {{ content | escape }} или {% raw %} сломают рендер.

Стили

В markdown-блоке обязательно прописывать стили для всех тегов, которые может породить markdown-редактор:

h1, h2, h3, h4, h5, h6, p, a, ul, ol, blockquote, code, pre, table, thead, tbody, tr, th, td, hr, strong, em, del

Без этого markdown будет выглядеть голым текстом (браузерные дефолты). Полный CSS-шаблон с типографикой — references/markdown-block.md.

Скрипты — нет

Markdown-блок без интерактивности. Скриптов в этом скилле нет. Все технические операции — через соседей:

• Стянуть данные / опубликовать → pagecraft-api
• Если нужны серверные данные внутри markdown-блока → редкий кейс, но возможен — pagecraft-block-ssr + data.* в шаблоне рядом с {{ content }}
• Валидировать schema.json → pagecraft-schema-block (validate-schema.js)
• Собрать preview.html → pagecraft-block/scripts/build-preview.js (зовётся из orchestrator)

Справочник

references/markdown-block.md — полный гайд: формат block.json, типичная схема обвеса (theme/size/full_width), CSS-шаблон со всеми тегами markdown, типографика, чек-лист, пример.

Пример

examples/markdown-section/ — рабочий markdown-блок: темы, типографика всех MD-элементов, full-width.

Типичные ошибки

• {% raw %}{{ content | escape }}{% endraw %} — контент уже HTML, экранировать нельзя.
• В CSS нет правил для h1–h6, p, a, ul, ol, blockquote, code, pre, table — markdown выглядит голым.
• block_type не выставлен в "markdown" — редактор не покажет markdown-редактор.
• Использование props.content или props.body для основного текста — это не схема-блок, основной контент берётся только из markdown-редактора как {{ content }}.