Markdown to HTML Converter

Конвертация Markdown-файлов в красиво оформленный HTML со встроенным CSS, оптимизированный для WeChat Official Account и других платформ. Поддерживает подсветку кода, математику, Mermaid (рендеринг в PNG через headless Chrome), PlantUML, сноски, alerts, инфографику и опциональные концевые сноски для внешних ссылок.

Выбор инструмента ввода

Приоритет: встроенный (AskUserQuestion) → нумерованное текстовое сообщение. Объединяйте вопросы в один вызов.

Директория скриптов

{baseDir} — директория SKILL.md. ${BUN_X}: предпочтительно bun, иначе npx -y bun. Основной скрипт: {baseDir}/scripts/main.ts.

Настройки (EXTEND.md)

Пути поиска в порядке приоритета:

Если ни один не найден — использовать значения по умолчанию.

EXTEND.md поддерживает: тема по умолчанию, кастомные CSS-переменные, стиль блоков кода, настройки Mermaid (mermaid_theme, mermaid_scale, mermaid_background).

Рабочий процесс

Шаг 0: Предпроверка (китайский контент)

Выполняется только если входной файл содержит китайский текст.

1. Прочитать входной markdown-файл
2. Проверить наличие CJK-символов (китайский/японский/корейский)
3. Нет CJK → перейти к шагу 1

При обнаружении CJK и наличии скилла baoyu-format-markdown — спросить через AskUserQuestion, форматировать ли перед конвертацией. Форматирование исправляет: ошибки парсинга ** из-за пунктуации внутри маркеров, проблемы с пробелами CJK/латиница.

Шаг 1: Определить тему

Порядок приоритетов (первое совпадение):

1. Явно указана пользователем (CLI --theme или в разговоре)
2. default_theme в EXTEND.md этого скилла
3. default_theme из EXTEND.md скилла baoyu-post-to-wechat (кросс-скилл fallback)
4. Не найдена → спросить через AskUserQuestion

Шаг 1.5: Режим концевых сносок

По умолчанию выключен. Активировать только по явной просьбе пользователя (WeChat-совместимый вывод с внешними ссылками в виде сносок внизу).

Шаг 2: Конвертация

${BUN_X} {baseDir}/scripts/main.ts \
  --input article.md \
  --theme default \
  --output article.html

Темы

Поддерживаемые расширения Markdown