Repolode
alchaincyf

alchaincyf/huashu-md-html

Навык в стиле Claude Code конвертирует файлы и веб-страницы в Markdown, превращает Markdown в HTML с оформлением или DOCX для печати, а также сохраняет HTML обратно в Markdown.

Звёзды
920
Форки
98
Открытые issues
6
Последний коммит
8 дней назад

Что это?

huashu-md-html — набор скриптов для конвертации, упакованных в навык для AI-агентов. Он преобразует PDF, DOCX, PPTX, XLSX, EPUB, изображения, аудио, видео с YouTube и URL-адреса веб-страниц в Markdown с помощью markitdown. Кроме того, он преобразует Markdown в HTML с одной из четырёх встроенных тем в виде отдельных файлов (article, report, reading, interactive) на базе Pandoc.

В обратном направлении навык извлекает основное содержимое опубликованной HTML-страницы или сайта по URL в Markdown с помощью html-to-markdown и trafilatura, удаляя навигацию и боковые панели. Отдельный скрипт создаёт DOCX из Markdown с готовыми книжными шаблонами, в которые входят обложка, оглавление, колонтитулы, разрывы страниц между главами и варианты формата страниц 32-open или A4.

Навык устанавливается командой npx skills add и рассчитан на работу с разными агентами, например Claude Code и Cursor. При запуске скрипты проверяют зависимости и сообщают об отсутствующих пакетах, а не завершаются без объяснений.

Ключевые возможности

  • 01Преобразует PDF, файлы Office, EPUB, изображения, аудио, видео с YouTube и URL-адреса веб-страниц в Markdown.
  • 02Преобразует Markdown в HTML с помощью четырёх автономных тем, которым не нужен внешний CDN.
  • 03Извлекает основной текст статей с веб-страниц и удаляет навигацию, боковые панели и рекламу.
  • 04Создаёт DOCX в книжном оформлении: с обложкой, оглавлением, колонтитулами и разрывами страниц между главами.
  • 05Работает как навык для разных AI-агентов и устанавливается командой npx skills add.

Сценарии использования

  • Преобразование PDF с аналитическим докладом в удобную для чтения HTML-страницу с темой report.
  • Сохранение опубликованной записи в блоге обратно в исходный формат Markdown.
  • Подготовка оформленной рукописи в DOCX для редактора или системы подачи материалов.
  • Преобразование страницы веб-документации в структурированный Markdown для AI-ассистента.

Быстрый старт

  1. 1

    Установите skill с помощью skills.sh

    npx skills add alchaincyf/huashu-md-html
  2. 2

    Установите зависимости Python для markitdown

    python3 -m pip install 'markitdown[all]'
  3. 3

    Установите pandoc (пример для macOS приведён в README)

    brew install pandoc
  4. 4

    Преобразуйте файл Markdown в HTML-страницу со стилями

    python3 scripts/md_to_html.py article.md --theme article -o article.html

Что важно знать

  • Требуются Python 3 и несколько внешних инструментов, например pandoc; для некоторых функций нужны дополнительные пакеты pip.
  • Решение предназначено для работы в качестве навыка агента; отдельного графического интерфейса нет.

Темы

Частые вопросы

Что такое huashu-md-html?
Навык в стиле Claude Code конвертирует файлы и веб-страницы в Markdown, превращает Markdown в HTML с оформлением или DOCX для печати, а также сохраняет HTML обратно в Markdown. huashu-md-html — набор скриптов для конвертации, упакованных в навык для AI-агентов. Он преобразует PDF, DOCX, PPTX, XLSX, EPUB, изображения, аудио, видео с YouTube и URL-адреса веб-страниц в Markdown с помощью markitdown. Кроме того, он преобразует Markdown в HTML с одной из четырёх встроенных тем в виде отдельных файлов (article, report, reading, interactive) на базе Pandoc.
huashu-md-html можно использовать бесплатно? Какая у него лицензия?
huashu-md-html распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
huashu-md-html всё ещё поддерживается?
Активно поддерживается. Последний коммит в huashu-md-html — 13 окт. 2026 г..
Для чего можно использовать huashu-md-html?
Преобразование PDF с аналитическим докладом в удобную для чтения HTML-страницу с темой report. Сохранение опубликованной записи в блоге обратно в исходный формат Markdown. Подготовка оформленной рукописи в DOCX для редактора или системы подачи материалов. Преобразование страницы веб-документации в структурированный Markdown для AI-ассистента.
Как установить huashu-md-html?
Установите skill с помощью skills.sh: npx skills add alchaincyf/huashu-md-html Установите зависимости Python для markitdown: python3 -m pip install 'markitdown[all]' Установите pandoc (пример для macOS приведён в README): brew install pandoc Преобразуйте файл Markdown в HTML-страницу со стилями: python3 scripts/md_to_html.py article.md --theme article -o article.html
Где скачать huashu-md-html?
Исходный код и инструкции по установке — на GitHub: https://github.com/alchaincyf/huashu-md-html

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты