ONEDEV

huashu-md-html

alchaincyf파일 37개

★ 905주당 +3조회 5

무엇인가

문서 형식 변환 파이프라인을 규율하는 스킬이다. markdown을 편집 가능한 소스로, HTML과 docx를 산출물로 두고, 각 방향 전환을 고정된 스크립트 하나씩에 대응시킨다. 에이전트가 변환 명령을 즉석에서 조합하지 않고 지정된 진입점을 호출하도록 강제하는 것이 핵심 규칙이다.

어떻게 동작하나

SKILL.md가 에이전트용 주 문서이고, references/ 아래에 markitdown-cookbook.md·md-to-html-themes.md·html-to-md-cookbook.md·md-to-docx-cookbook.md·design-tokens.md·anti-ai-slop.md가 작업별로 분리되어 있다. templates/에는 article(Tufte풍)·report(백서풍)·reading(Medium풍)·interactive(장문 내비게이션)·wechat 5개 테마가 단일 CSS로 들어 있다. 별도 슬래시 명령이나 훅이 아니라, "이 PDF를 md로" 같은 자연어 요청을 받으면 SKILL.md의 대응 규칙에 따라 scripts/any_to_md.py·md_to_html.py·html_to_md.py·md_to_docx.py 중 하나를 실행하는 방식으로 발동한다.

무엇과 다른가

pandoc 명령과 CSS를 프롬프트에서 매번 새로 작성하는 방식과 다르다. URL 입력은 읽기용이면 trafilatura 경로(능력 3), 조회용이면 markitdown 경로(능력 1)로 갈라지는 판단 기준이 문서에 명시되어 있고, 테마별 타이포그래피 토큰(본문 행간 1.75~1.85, 데스크톱 17~18px, 최대 폭 680~820px, 코드블록 #F6F8FA)과 금지 목록(보라 그라디언트, #0D1117 배경, 이모지 아이콘)이 파일로 고정되어 있다. md→docx는 pandoc 기본 출력 대신 python-docx 기반 스크립트로 표지·목차·머리글·장별 페이지 나눔을 넣는다.

어떻게 쓰나

설치는 npx skills add alchaincyf/huashu-md-html 한 줄이며 Claude Code·Cursor·Codex·OpenClaw·Hermes에 붙는다. 설치 후에는 자연어로 요청하거나 스크립트를 직접 호출한다. 예: python3 scripts/any_to_md.py whitepaper.pdf -o whitepaper.md 후 python3 scripts/md_to_html.py whitepaper.md --theme report -o whitepaper.html. 책 단위 docx는 여러 md 파일과 --book --title --author --images-dir 플래그를 함께 넘긴다.

전제와 한계

Python 3와 python-docx·Pillow, 그리고 markitdown·Pandoc·trafilatura·html-to-markdown이 필요하다. 스크립트는 시작 시 의존성을 자체 점검하고 누락분의 설치 명령을 출력한다. macOS에서 pip와 python3가 서로 다른 버전을 가리킬 수 있어 python3 -m pip install 사용을 권장한다. 변환은 로컬 스크립트 실행이므로 에이전트가 파일 시스템과 네트워크에 접근할 수 있어야 하며, 4개 테마는 HTML 출력에만 적용되고 docx 서식은 스크립트 내장 프리셋으로 고정된다.

유사 스킬