Markdown, HTML, LaTeX, DOCX 등 수십 가지 마크업 형식 간에 문서를 변환하는 Haskell 라이브러리이자 CLI입니다.
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
skills.sh로 스킬 설치
npx skills add alchaincyf/huashu-md-html - 2
markitdown용 Python 종속성 설치
python3 -m pip install 'markitdown[all]' - 3
pandoc 설치(README의 macOS 예시 참고)
brew install pandoc - 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 통계는 매일 갱신됩니다.
관련 프로젝트
AI 에이전트의 어려운 질문 답변을 다이어그램과 표를 갖춘 오프라인 HTML 페이지로 만드는 에이전트 스킬입니다.
텍스트 프롬프트를 프로토타입, 슬라이드 덱, 애니메이션, 인포그래픽으로 만드는 AI 코딩 에이전트용 HTML 네이티브 디자인 스킬입니다.
코딩 에이전트가 다이어그램, diff 리뷰, 계획, 표를 ASCII 아트 대신 스타일이 적용된 HTML 페이지로 렌더링하게 하는 에이전트 스킬입니다.
AI 에이전트가 웹 페이지를 검색하고 스크래핑하며 상호작용할 수 있는 API로, 정제된 Markdown, JSON, 스크린샷을 반환합니다.
PDF, Office 문서, HTML, 이미지, 오디오 등을 Markdown으로 변환해 LLM 및 텍스트 분석 파이프라인에 활용하는 Python 유틸리티입니다.