Repolode
alchaincyf

alchaincyf/huashu-md-html

Skill no estilo do Claude Code que converte arquivos e páginas da web em Markdown, transforma Markdown em HTML com estilo ou DOCX pronto para impressão e arquiva HTML de volta em Markdown.

Estrelas
920
Forks
98
Issues abertas
6
Último commit
há 8 dias

O que é?

huashu-md-html é um conjunto de scripts de conversão empacotado como uma skill de agente. Converte PDF, DOCX, PPTX, XLSX, EPUB, imagens, áudio, vídeos do YouTube e URLs da web em Markdown usando markitdown. Também renderiza Markdown em HTML com quatro temas independentes em arquivo único (article, report, reading, interactive), criados com Pandoc.

No sentido inverso, extrai o conteúdo principal de uma página HTML publicada ou URL e o converte de volta para Markdown usando html-to-markdown e trafilatura, removendo a navegação e as barras laterais. Um script separado cria um DOCX a partir de Markdown com predefinições no estilo de livro, incluindo capa, sumário, cabeçalhos e rodapés, quebras de página entre capítulos e formatos de página 32-open ou A4.

A skill é instalada com npx skills add e foi projetada para funcionar com diferentes agentes, como Claude Code e Cursor. Seus scripts verificam as dependências na inicialização e informam quais pacotes estão faltando, em vez de falhar silenciosamente.

Recursos principais

  • 01Converte PDF, arquivos do Office, EPUB, imagens, áudio, vídeos do YouTube e URLs da web em Markdown.
  • 02Renderiza Markdown em HTML com quatro temas autocontidos que não precisam de CDN externa.
  • 03Extrai o conteúdo de artigos de páginas da web e remove navegação, barras laterais e anúncios.
  • 04Cria DOCX no estilo de livro, com capa, sumário, cabeçalhos, rodapés e quebras entre capítulos.
  • 05Funciona como uma skill compatível com vários agentes, instalável com npx skills add.

Casos de uso

  • Transformar um white paper em PDF em uma página HTML fácil de ler com o tema report.
  • Arquivar uma publicação de blog já publicada de volta como código-fonte Markdown.
  • Gerar um DOCX formatado de um manuscrito para um editor ou sistema de submissão.
  • Converter a página de documentação de um site em Markdown estruturado para um assistente de IA.

Início rápido

  1. 1

    Instale a skill com skills.sh

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

    Instale as dependências Python do markitdown

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

    Instale o pandoc (exemplo para macOS no README)

    brew install pandoc
  4. 4

    Converta um arquivo Markdown em uma página HTML com estilo

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

Antes de usar

  • Requer Python 3 e várias ferramentas externas, como pandoc; alguns recursos precisam de pacotes pip adicionais.
  • Foi projetado para funcionar como uma skill de agente; não há uma interface gráfica independente.

Tópicos

Perguntas frequentes

O que é huashu-md-html?
Skill no estilo do Claude Code que converte arquivos e páginas da web em Markdown, transforma Markdown em HTML com estilo ou DOCX pronto para impressão e arquiva HTML de volta em Markdown. huashu-md-html é um conjunto de scripts de conversão empacotado como uma skill de agente. Converte PDF, DOCX, PPTX, XLSX, EPUB, imagens, áudio, vídeos do YouTube e URLs da web em Markdown usando markitdown. Também renderiza Markdown em HTML com quatro temas independentes em arquivo único (article, report, reading, interactive), criados com Pandoc.
huashu-md-html é gratuito? Qual é a licença?
huashu-md-html é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
huashu-md-html ainda é mantido?
Manutenção ativa. O último commit de huashu-md-html foi em 13 de out. de 2026.
Para que posso usar huashu-md-html?
Transformar um white paper em PDF em uma página HTML fácil de ler com o tema report. Arquivar uma publicação de blog já publicada de volta como código-fonte Markdown. Gerar um DOCX formatado de um manuscrito para um editor ou sistema de submissão. Converter a página de documentação de um site em Markdown estruturado para um assistente de IA.
Como instalar huashu-md-html?
Instale a skill com skills.sh: npx skills add alchaincyf/huashu-md-html Instale as dependências Python do markitdown: python3 -m pip install 'markitdown[all]' Instale o pandoc (exemplo para macOS no README): brew install pandoc Converta um arquivo Markdown em uma página HTML com estilo: python3 scripts/md_to_html.py article.md --theme article -o article.html
Onde consigo huashu-md-html?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alchaincyf/huashu-md-html

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados