ystherr/wechat-article-formatter-skill

wechat-article-formatter-skill은(는) 무엇을 하나요?

🎨 마크다운을 스타일이 적용된 위챗 아티클용 HTML로 포맷팅하며, 자동 이미지 업로드와 최적의 가독성을 위한 커스텀 CSS를 제공합니다.

개요

이 스킬은 마크다운 문서를 위챗 공식 계정(WeChat Official Account) 게시글에 적합한 HTML로 변환합니다. 일반적인 마크다운 변환기와 달리, 이 스킬은 위챗 에디터의 제약사항을 고려한 스타일링을 적용하며, 이미지를 자동으로 업로드하고 CSS를 통해 가독성을 높입니다.

주요 기능

• 마크다운 → 위챗 HTML 변환: 헤더, 리스트, 코드 블록, 인용구 등 주요 마크다운 요소를 위챗 친화적인 HTML로 변환합니다.
• 자동 이미지 업로드: 문서 내 이미지 URL을 위챗 CDN에 자동으로 업로드하고 최종 HTML에 포함시킵니다.
• 커스텀 CSS: 위챗 아티클에서 가독성을 높이기 위해 사전 정의된 CSS 스타일을 적용합니다.
• 코드 구문 강조: 프로그래밍 코드 블록에 대한 구문 강조를 지원합니다.

사용 방법

이 스킬은 다음 환경에서 사용할 수 있습니다:

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 플랫폼

기본 사용법:

# 마크다운 파일을 변환하여 위챗 HTML 생성
wechat-format input.md

옵션:

옵션	설명	기본값
--css	커스텀 CSS 파일 경로	기본 내장 CSS
--no-images	이미지 업로드 비활성화	false
--output	출력 파일 경로	stdout

설정

환경 변수 또는 설정 파일을 통해 다음 항목을 구성할 수 있습니다:

• WECHAT_APP_ID: 위챗 앱 ID
• WECHAT_APP_SECRET: 위챗 앱 시크릿
• WECHAT_ACCESS_TOKEN: 위챗 액세스 토큰 (선택 사항)

출력 예시

변환된 HTML은 위챗 에디터에 직접 복사하여 붙여넣을 수 있습니다. 스타일이 적용된 최종 결과는 다음과 같습니다:

• 제목은 위챗 스타일에 맞게 조정됩니다.
• 코드 블록은 <pre><code> 태그로 감싸지며 구문 강조가 적용됩니다.
• 이미지는 위챗 CDN URL로 교체됩니다.
• 링크는 위챗에서 지원되는 방식으로 변환됩니다.

참고 사항

• 이미지 업로드를 위해서는 유효한 위챗 액세스 토큰이 필요합니다.
• 변환된 HTML은 위챗 공식 계정 에디터에서만 최적의 결과를 제공합니다.
• 대용량 문서의 경우 처리 시간이 다소 소요될 수 있습니다.

라이선스

MIT