Communitygithub.com

zjp1997720/wechat-styler

Markdown을 WeChat 공식 계정용 인라인 스타일 HTML로 변환합니다. 10가지 테마, 결정론적 검증, 플레이스홀더 지원.

wechat-styler란 무엇인가요?

이 스킬은 Markdown 문서를 WeChat 공식 계정(公众号)에 바로 붙여넣을 수 있는 인라인 스타일 HTML로 변환해주는 도구입니다. 10가지 기본 제공 테마(zhijian, kami, magazine 시리즈 5종, elegant, modern, minimal)를 지원하며, 각 테마는 단순한 색상 변경이 아닌 고유한 타이포그래피와 레이아웃 레퍼토리를 갖추고 있어 다양한 콘텐츠 스타일에 맞게 활용할 수 있습니다. CLI 명령어를 통해 변환을 실행하며, 테마, 글꼴 크기, 강조 색상 등을 사용자 정의할 수 있습니다. 특히 WeChat 편집기로 붙여넣을 때 발생하는 스타일 손실 문제를 방지하기 위해 `scripts/validate.mjs`를 통한 결정론적 검증을 수행, 모든 배경색을 solid hex로 사용하고 스타일을 완전히 인라인화하여 붙여넣기 후에도 일관된 디자인을 유지합니다. 또한 아직 이미지가 준비되지 않은 경우 사용할 수 있는 플레이스홀더 메커니즘을 제공하여, 콘텐츠 초안 단계에서도 레이아웃을 미리 확인할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

WeChat Styler 좌우 병렬 효과 미리보기
alt
이미지 설명

문서

WeChat Styler - 公众号排版工具

Markdown 문서를 우아한 WeChat 공식 계정 HTML 형식으로 변환합니다. 여러 테마를 지원합니다.

효과 미리보기

2026-06-30에 수집한 실제 WorkBuddy 문서 발췌문으로 생성했습니다. 왼쪽이 원본 Markdown, 오른쪽이 zhijian 테마 출력입니다.

WeChat Styler 좌우 병렬 효과 미리보기

사용 방법

# 기본 사용법 (기본 테마 사용)
/wechat-styler path/to/article.md

# 테마 지정
/wechat-styler path/to/article.md --theme kami
/wechat-styler path/to/article.md --theme magazine-ink

# 일괄 변환 (glob 패턴 지원)
/wechat-styler "articles/*.md" --theme kami
/wechat-styler "01_项目/内容创作/**/*.md" --theme magazine-ink

# 사용자 정의 매개변수
/wechat-styler path/to/article.md --theme kami --font-size 17 --accent-color "#1B365D"

# 특정 경로로 출력 (단일 파일)
/wechat-styler path/to/article.md --output path/to/output.html

사용 가능한 테마

0. zhijian(智见AI 브랜드 테마)- 기본 테마

오픈소스 고지: 이는 브랜드 시스템(색상 + 글꼴 + 타이포그래피 개성)을 skill에 고정하는 방법을 보여주는 예시 브랜드 테마입니다. 작성자 자신의 브랜드 디자인 시스템에서 가져왔습니다. 그대로 사용하거나, 그 구조를 참고하여 themes/zhijian.yaml을 자신만의 브랜드 테마(색상, 글꼴, top_label 변경)로 수정할 수 있습니다.

특징:

  • DESIGN.md 브랜드 시스템 기반, 따뜻한 종이 질감 × 컨설턴트 신뢰도
  • 종이 질감 배경 #F5F4ED, 진한 따뜻한 테라코타 액션 컬러 #B85235, 먹물 블루 구조색 #1B365D
  • 3단계 글꼴 전략: 제목은 명조체(브랜드 감성), 본문은 송조체(가독성), UI는 고딕체(기능성)
  • H2 왼쪽 따뜻한 테라코타 세로선, H3 먹물 블루 색상, 인용 블록 Human Accent 왼쪽 선
  • 코드 블록 따뜻한 검정 배경 12px 모서리 둥글게, 인라인 코드 먹물 블루 색상에 밝은 파란색 배경
  • 굵게 및 링크는 #A04A2E 사용 (WCAG AA 안전 따뜻한 색상)
  • 구분선은 따뜻한 테라코타 색상 짧은 가로선 중앙 정렬

적용 시나리오: 모든 智见AI 브랜드 콘텐츠 — 공식 계정 글, 교육 자료, 강의 콘텐츠, 방법론 공유, AI 도입 사례

매개변수:

font_family_cn: 'Source Han Serif SC','Noto Serif CJK SC','Songti SC',Georgia,serif
font_family_en: 'Georgia','Source Serif 4','Charter','Times New Roman',serif
font_size: 17
line_height: 1.58
accent_color: '#B85235'
accest_secondary: '#1B365D'
background_color: '#F5F4ED'
surface_color: '#FAF9F5'
text_color: '#141413'
heading_font: 'TsangerJinKai02','Source Han Serif SC','Noto Serif CJK SC','Songti SC',Georgia,serif
ui_font: 'Source Han Sans SC','Noto Sans CJK SC','PingFang SC',-apple-system,sans-serif
code_font: 'JetBrains Mono','SF Mono','Fira Code',Consolas,Monaco,'Source Han Serif SC',monospace
code_bg: '#30302E'
code_color: '#F5F4ED'

1. kami(紙感 편집·레터프레스)

특징:

  • 따뜻한 양피지(paper feel) 배경: #f5f4ed
  • 잉크 블루 단일 강조색: #1B365D
  • 중문 제목은 세리프/명조체 스택, 본문은 안정적인 산세리프 스택 사용
  • 따뜻한 회색조, 차가운 회색과 순백색 배경 미사용
  • 제목 왼쪽 파란색 세로선, solid tag 배경, 절제된 인용 블록
  • 모든 배경색은 solid hex를 사용하며, 외부 레이어, 콘텐츠 레이어, 텍스트 레이어에 중복 선언하여 WeChat에 붙여넣은 후 배경색 손실 위험 감소

적용 시나리오: 공식 계정 심층 기사, 비즈니스 분석, 강의 콘텐츠, 공식 설명문

매개변수:

font_family_cn: 'Inter','TsangerJinKai02','Source Han Sans SC','Noto Sans CJK SC','PingFang SC','Microsoft YaHei',Arial,sans-serif
font_family_en: 'Newsreader','Source Serif 4','Source Serif Pro','Charter',Georgia,'Times New Roman',serif
font_size: 16
line_height: 1.55
accent_color: '#1B365D'
background_color: '#f5f4ed'
surface_color: '#faf9f5'
text_color: '#141413'
secondary_color: '#5e5d59'
heading_font: 'TsangerJinKai02','Source Han Serif SC','Noto Serif CJK SC','Songti SC','STSong',Georgia,serif
code_font: 'JetBrains Mono','SF Mono','Fira Code',Consolas,Monaco,'TsangerJinKai02','Source Han Serif SC',monospace

2. magazine 시리즈(전자 잡지 × 전자 잉크)

magazine-web-ppt에서 마이그레이션한 5가지 프리셋으로, ink / paper / tint의 잡지 색상 관계를 유지하면서 WeChat 공식 계정 안전 HTML로 개조했습니다. rgba()를 사용하지 않으며, 모든 배경색은 solid hex입니다.

테마명령어변형글꼴 / 타이포그래피 개성
잉크 클래식--theme magazine-inkink-classic산세리프 본문 + 세리프 제목, 가는 rule, dash list, pull quote, 일반 잡지 내지
인디고 블루--theme magazine-indigoindigo-researchInter/SF Pro 본문 + Source Serif 제목, 왼쪽 연구 컬럼, note quote, 기술 코드 블록
포레스트 잉크--theme magazine-forestfored-fieldnote명조체/송조체 본문 + 논픽션 제목, 중앙 정렬 제목, field note 인용, 자연 이미지 캡션
크라프트지--theme magazine-kraftkraft-archive송조체 본문 + archive 제목 상자, 아카이브 스타일 인용, 로마 숫자 순서 목록, 오래된 종이 코드 프레임
듄--theme magazine-dunedune-galleryAvenir 본문 + Didot/Bodoni 제목, 오른쪽 정렬 갤러리 제목, gallery quote, 미니멀 이미지 캡션

공통 특징:

  • 각 테마는 독립적인 글꼴 스택, 글자 크기, 줄 간격, 단락 간격, 제목 구조, 목록 marker, 인용 블록, 코드 블록 및 이미지 캡션을 갖습니다.
  • 구분은 여백, 짧은 연한 선 및 국부적 식별자에 의존하며, 각 섹션 사이에 자동으로 전체 너비 실선을 삽입하지 않습니다.
  • 다섯 테마는 magazine-editorial 렌더러 진입점을 공유하지만 magazine_variant를 통해 다른 구조 분기로 이동하며, 단순히 색상만 바꾸는 것이 아닙니다.
  • 모든 배경색은 solid hex를 사용하며, 블록과 텍스트 span에 background-color를 중복 선언하여 WeChat 편집기에 복사한 후 배경색이 손실될 확률을 낮춥니다.
  • 이미지 자체에 margin:0 auto 중앙 정렬을 적용하여, 공식 계정 편집기가 복사 후 이미지 너비를 변경하여 이미지가 왼쪽으로 치우치는 것을 방지합니다.
  • 레이아웃은 잡지 감성을 유지하지만 출력은 완전히 인라인 스타일이므로 공식 계정 편집기에 바로 복사할 수 있습니다.

3. elegant(우아한 복고풍)

특징:

  • 중문: 方正书宋(FZShuSong-Z01)
  • 영문: Garamond
  • 전체적으로 옅은 회색 배경
  • 빨간색 강조 색상 시스템
  • 세리프 제목 + 고정폭 코드

적용 시나리오: 비즈니스 사례, 심층 분석, 지식 공유

매개변수:

font_family_cn: 'FZShuSong-Z01','Songti SC',STSong,serif
font_family_en: 'Garamond',serif
font_size: 16
line_height: 1.9
accent_color: '#cf4436'
background_color: '#f7f6f1'
heading_font: 'Noto Serif SC','Songti SC',STSong,Georgia,serif
code_font: 'JetBrains Mono','SF Mono',Menlo,Consolas,monospace

4. modern(모던 심플)

특징:

  • 산세리프 글꼴
  • 순백색 배경
  • 파란색 강조색
  • 명확하고 현대적인

적용 시나리오: 테크 제품, 튜토리얼, 속보

매개변수:

font_family_cn: 'PingFang SC','Hiragino Sans GB','Microsoft YaHei',sans-serif
font_family_en: 'SF Pro Display','Helvetica Neue',sans-serif
font_size: 16
line_height: 1.8
accent_color: '#007aff'
background_color: '#ffffff'
heading_font: 'PingFang SC','Hiragino Sans GB',sans-serif
code_font: 'SF Mono',Menlo,Consolas,monospace

5. minimal(미니멀리즘)

특징:

  • 미니멀 흑백
  • 넉넉한 여백
  • 회색조
  • 절제된 우아함

적용 시나리오: 철학적 사색, 개인 에세이, 예술 비평

매개변수:

font_family_cn: 'Noto Sans SC','PingFang SC',sans-serif
font_family_en: 'Inter','Helvetica Neue',sans-serif
font_size: 15
line_height: 2.0
accent_color: '#333333'
background_color: '#fafafa'
heading_font: 'Noto Sans SC',sans-serif
code_font: 'JetBrains Mono',monospace

Renderer Presets

테마는 단순히 색상만 바꾸는 것이 아닙니다. 각 테마는 Markdown 렌더링 페르소나와 연결되어 제목, 본문, 인용, 목록, 코드, 이미지 캡션의 구조, 글자 크기, 줄 높이, 간격 및 글꼴 두께를 담당합니다.

Preset연결 테마레이아웃 어조
zhijian-warm-paperzhijian브랜드 교안: 따뜻한 테라코타 세로선 제목, 먹물 블루 3단계 제목, Human Accent 인용, 따뜻한 검정 코드 블록
kami-documentkami종이 감성 문서: 격식 있고 절제된, 제목 왼쪽 ink-blue 세로선
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune전자 잡지 패밀리: magazine_variant를 통해 classic / research / fieldnote / archive / gallery 5가지 레이아웃 각각 표현
elegant-essayelegant복고풍 장문: 중앙 정렬 제목, 여유로운 줄 간격, 발췌식 인용
modern-technicalmodern현대 튜토리얼: 산세리프 계층, 팁 카드, 기술 코드 블록
minimal-notesminimal미니멀 노트: 낮은 장식, 넉넉한 여백, 가는 선 인용

공식 계정 호환 하드 규칙: 모든 preset 출력은 inline style입니다. 배경색은 solid hex를 사용합니다. 외부 section, 콘텐츠 section, 텍스트 span이 background-color를 중복 선언합니다.

테마 매개변수 설명

매개변수설명기본값
--theme테마 이름zhijian
--font-size본문 글자 크기 (px)17
--line-height줄 높이1.58
--accent-color강조 색상 (제목, 링크)#B85235
--background-color배경색, solid hex 사용 필수#F5F4ED
--max-width콘텐츠 최대 너비 (px)640
--output출력 파일 경로자동 생성

출력 규칙

기본 출력 경로:

  • 입력: path/to/article.md
  • 출력: path/to/article_wechat.html

출력 내용:

  1. 완전한 HTML 파일
  2. 인라인 스타일 (공식 계정에 바로 복사 가능)
  3. 이미지 링크 유지
  4. 코드 블록, 인용 블록, 목록 등 자동 처리

작업 흐름

  1. Markdown 파일 읽기

    • frontmatter 파싱 (제목, 요약 등)
    • 본문 내용 추출
  2. 테마 설정 로드

    • 테마 매개변수 읽기
    • 사용자 정의 매개변수 적용
  3. HTML로 변환

    • Markdown → HTML 구조
    • 테마 스타일 적용 (인라인)
    • 특수 요소 처리 (코드, 이미지, 인용)
  4. 파일 출력

    • 완전한 HTML 생성
    • 지정된 경로에 저장
    • 사용 설명 출력

테마 미리보기

어떤 테마를 선택할지 확신이 없으신가요? 테마 미리보기 생성기를 사용하여 모든 테마 효과를 비교하세요:

# 모든 테마의 미리보기 페이지 생성 (기본 예시 문서 사용)
node scripts/generate-preview.mjs

# 사용자 문서로 미리보기 생성
node scripts/generate-preview.mjs path/to/your-article.md

# 특정 테마만 미리보기 (쉼표로 구분, 공백 없음)
node scripts/generate-preview.mjs article.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# 사용자 정의 출력 경로
node scripts/generate-preview.mjs article.md --themes kami,elegant --output /path/to/my-preview.html

미리보기 페이지는 선택한 테마의 효과를 나란히 보여주어 빠르게 비교하고 선택할 수 있습니다. 생성된 preview.html은 브라우저에서 열어 볼 수 있습니다.

새 테마 확장

단계:

  1. themes/ 디렉토리에 새 테마 설정 파일 생성:

    # themes/my-theme.yaml
    name: my-theme
    description: 나의 사용자 정의 테마
    font_family_cn: 'Custom Font CN'
    font_family_en: 'Custom Font EN'
    font_size: 16
    line_height: 1.8
    accent_color: '#ff6b6b'
    background_color: '#f8f9fa'
    heading_font: 'Heading Font'
    code_font: 'Code Font'
    
  2. 새 테마 사용:

    /wechat-styler article.md --theme my-theme
    

공식 계정 호환 하드 규칙

다음 규칙은 scripts/validate.mjs에 의해 결정론적으로 실행되며, 모델의 자의식에 의존하지 않습니다. 변환 산출물은 자동으로 검증됩니다. node scripts/validate.mjs output.html을 독립적으로 실행하여 재확인할 수 있습니다 (오류 없으면 0으로 종료, 오류 있으면 1로 종료, CI/자동화용).

변환은 소프트 게이트 전략을 사용합니다. ERROR 발견 시 파일은 정상적으로 생성되지만 (사용자가 먼저 효과를 볼 수 있음), 마지막에 빨간색 오류 보고서 세부 사항을 출력합니다. 독립 실행형 validate 스크립트만 0이 아닌 종료 코드를 반환합니다.

ERROR 레벨 (산출물에 반드시 0이어야 함, 그렇지 않으면 붙여넣기 후 문제 발생)

  1. 금지 태그: <style> / <script> / <link> / <iframe> / body 내 <meta> / <input>
    • 이유: 공식 계정 편집기가 제거하여 스타일/스크립트/외부 리소스가 무효화됨
  2. 금지 속성: class= / id= / contenteditable
    • 이유: 공식 계정 편집기가 제거, 스타일은 모두 style에 인라인으로 있어야 함
  3. 금지 CSS: position:fixed|absolute / display:grid|flex / @media / @keyframes
    • 이유: 붙여넣기 후 위치 오류, 레이아웃 붕괴 또는 무시됨
  4. 금지 함수: rgba() / hsla()
    • 이유: 배경색이 편집기에서 손실되므로 solid hex를 사용해야 함 (예: #1B365D, rgba(27,54,93,0.8) 아님)
  5. 금지 외부 글꼴: @font-face의 url(...) 외부 참조
    • 이유: 로드 실패 시 폴백, 레이아웃 변형; 시스템 글꼴 스택 사용

WARN 레벨 (수정 권장, 차단하지 않음)

  1. 이미지에 alt 없음: <img>에 alt 속성 누락 (접근성 + 이미지 호스트 장애 시 폴백)
  2. 이미지 오프셋 위험: <img>에 margin:0 auto 또는 display:block 누락 (붙여넣기 후 왼쪽으로 치우칠 수 있음)
  3. 블록 요소에 style 누락: <p> / <h2> / <blockquote>에 style 속성 누락 (붙여넣기 후 스타일 손실)

convert.mjs에 이미 내장된 호환 전략 (수동 처리 불필요)

  • 모든 배경색은 solid hex를 사용, rgba() 사용 안 함
  • 외부 section / 콘텐츠 section / 텍스트 span 세 레이어에서 background-color를 중복 선언하여 붙여넣기 후 배경 손실 감소
  • 이미지 부모 text-align:center + 자체 margin:0 auto;display:block 이중 폴백으로 오프셋 방지
  • 모든 스타일 인라인, <style> 태그나 외부 CSS 사용 안 함

플레이스홀더 메커니즘

글을 쓰는 중에 이미지 호스트가 아직 준비되지 않았지만 레이아웃 효과를 먼저 보고 싶으신가요? Markdown에 플레이스홀더를 작성하면 convert가 중앙 정렬 점선 회색 상자로 렌더링합니다:

본문입니다.

【삽입:글 시작 부분의 비디오 스크린샷】

본문을 계속합니다.

렌더링 효과: 절제된 중성 회색 점선 상자 + 중앙 정렬 회색 글자「📷 보충 자료 대기: xxx」, 본문 시각적 흐름을 방해하지 않습니다. 이미지 준비 후 【삽입:xxx】를 ![alt](url)로 바꾸면 됩니다.

한 줄을 차지하는 【삽입:xxx】(전각 대괄호)만 지원합니다. 인라인에서는 트리거되지 않아 본문 오인식을 방지합니다.

예시

입력 Markdown:

---
title: 글 제목
summary: 글 요약
---

## 섹션 제목

본문입니다.**굵게** 및 `코드`를 포함합니다.

![이미지 설명](https://example.com/image.png)

> 인용문입니다.

출력 HTML:

  • 공식 계정에서 사용 가능한 완전한 HTML
  • 모든 스타일 인라인
  • 바로 복사하여 붙여넣기 가능

기술 구현

핵심 스크립트: scripts/convert.mjs (변환) + scripts/validate.mjs (공식 계정 호환성 검증)

의존성:

  • Node.js 18+
  • marked (Markdown 파싱)
  • js-yaml (YAML 파싱)

디렉토리 구조:

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → 공식 계정 HTML (소프트 게이트로 validate 호출)
│   ├── validate.mjs         # 공식 계정 호환성 검증 (독립 실행 가능 / convert에서 참조)
│   └── generate-preview.mjs # 테마 미리보기 페이지 생성기
├── themes/
│   ├── elegant.yaml
│   ├── kami.yaml
│   ├── magazine-dune.yaml
│   ├── magazine-forest.yaml
│   ├── magazine-indigo.yaml
│   ├── magazine-ink.yaml
│   ├── magazine-kraft.yaml
│   ├── modern.yaml
│   ├── minimal.yaml
│   └── zhijian.yaml
└── templates/
    └── base.html

최종 업데이트: 2026-07-07 버전: 1.4.0 저자: 大鹏

관련 스킬