Repolode
alchaincyf

alchaincyf/huashu-md-html

Claude Code 스타일의 스킬로, 파일과 웹 페이지를 Markdown으로 변환하고 Markdown을 스타일이 적용된 HTML이나 인쇄용 DOCX로 만들며 HTML을 Markdown으로 보관합니다.

스타
920
포크
98
열린 이슈
6
마지막 커밋
8일 전

어떤 프로젝트인가요?

huashu-md-html은 에이전트 스킬로 패키징된 변환 스크립트 모음입니다. markitdown을 사용해 PDF, DOCX, PPTX, XLSX, EPUB, 이미지, 오디오, YouTube 동영상, 웹 URL을 Markdown으로 변환합니다. 또한 Pandoc 기반의 번들 단일 파일 테마 4종(article, report, reading, interactive)을 사용해 Markdown을 HTML로 렌더링할 수 있습니다.

반대로 html-to-markdown과 trafilatura를 사용해 게시된 HTML 페이지나 URL에서 본문을 추출해 Markdown으로 변환하며, 탐색 메뉴와 사이드바는 제거합니다. 별도의 스크립트는 표지, 목차, 머리글과 바닥글, 장별 페이지 나누기를 포함한 책 스타일 프리셋으로 Markdown에서 DOCX를 생성합니다. 페이지 크기는 32절판 또는 A4를 지원합니다.

npx skills add로 설치할 수 있으며 Claude Code, Cursor 같은 여러 에이전트에서 작동하도록 설계되었습니다. 스크립트는 시작할 때 의존성을 확인하고, 누락된 패키지가 있으면 조용히 실패하는 대신 이를 알립니다.

핵심 기능

  • 01PDF, Office 파일, EPUB, 이미지, 오디오, YouTube 동영상, 웹 URL을 Markdown으로 변환합니다.
  • 02외부 CDN 없이 사용할 수 있는 독립형 테마 4종으로 Markdown을 HTML로 렌더링합니다.
  • 03웹 페이지에서 본문을 추출하고 탐색 메뉴, 사이드바, 광고를 제거합니다.
  • 04표지, 목차, 머리글, 바닥글, 장별 페이지 나누기를 포함한 책 스타일 DOCX를 생성합니다.
  • 05npx skills add로 설치할 수 있으며 여러 에이전트에서 작동하는 스킬입니다.

활용 사례

  • report 테마를 사용해 PDF 백서를 읽기 쉬운 HTML 페이지로 변환합니다.
  • 게시된 블로그 글을 Markdown 원본으로 보관합니다.
  • 편집자나 투고 시스템에 제출할 서식이 적용된 원고 DOCX를 만듭니다.
  • 웹 문서 페이지를 AI 어시스턴트가 활용할 수 있는 구조화된 Markdown으로 변환합니다.

빠른 시작

  1. 1

    skills.sh로 스킬 설치

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

    markitdown용 Python 종속성 설치

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

    pandoc 설치(README의 macOS 예시 참고)

    brew install pandoc
  4. 4

    Markdown 파일을 스타일이 적용된 HTML 페이지로 변환

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

사용 전 알아둘 점

  • Python 3와 pandoc 같은 여러 외부 도구가 필요하며, 일부 기능에는 추가 pip 패키지가 필요합니다.
  • 에이전트 스킬로 실행하도록 설계되었으며 독립 실행형 GUI는 없습니다.

토픽

자주 묻는 질문

huashu-md-html은(는) 무엇인가요?
Claude Code 스타일의 스킬로, 파일과 웹 페이지를 Markdown으로 변환하고 Markdown을 스타일이 적용된 HTML이나 인쇄용 DOCX로 만들며 HTML을 Markdown으로 보관합니다. huashu-md-html은 에이전트 스킬로 패키징된 변환 스크립트 모음입니다. markitdown을 사용해 PDF, DOCX, PPTX, XLSX, EPUB, 이미지, 오디오, YouTube 동영상, 웹 URL을 Markdown으로 변환합니다. 또한 Pandoc 기반의 번들 단일 파일 테마 4종(article, report, reading, interactive)을 사용해 Markdown을 HTML로 렌더링할 수 있습니다.
huashu-md-html은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
huashu-md-html은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
huashu-md-html은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. huashu-md-html의 마지막 커밋은 2026년 10월 13일입니다.
huashu-md-html은(는) 어디에 사용할 수 있나요?
report 테마를 사용해 PDF 백서를 읽기 쉬운 HTML 페이지로 변환합니다. 게시된 블로그 글을 Markdown 원본으로 보관합니다. 편집자나 투고 시스템에 제출할 서식이 적용된 원고 DOCX를 만듭니다. 웹 문서 페이지를 AI 어시스턴트가 활용할 수 있는 구조화된 Markdown으로 변환합니다.
huashu-md-html는 어떻게 설치하나요?
skills.sh로 스킬 설치: npx skills add alchaincyf/huashu-md-html markitdown용 Python 종속성 설치: python3 -m pip install 'markitdown[all]' pandoc 설치(README의 macOS 예시 참고): 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를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트