WeChat Styler - 公众号排版工具
Markdown 문서를 우아한 WeChat 공식 계정 HTML 형식으로 변환합니다. 여러 테마를 지원합니다.
효과 미리보기
2026-06-30에 수집한 실제 WorkBuddy 문서 발췌문으로 생성했습니다. 왼쪽이 원본 Markdown, 오른쪽이 zhijian 테마 출력입니다.

사용 방법
# 기본 사용법 (기본 테마 사용)
/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-ink | ink-classic | 산세리프 본문 + 세리프 제목, 가는 rule, dash list, pull quote, 일반 잡지 내지 |
| 인디고 블루 | --theme magazine-indigo | indigo-research | Inter/SF Pro 본문 + Source Serif 제목, 왼쪽 연구 컬럼, note quote, 기술 코드 블록 |
| 포레스트 잉크 | --theme magazine-forest | fored-fieldnote | 명조체/송조체 본문 + 논픽션 제목, 중앙 정렬 제목, field note 인용, 자연 이미지 캡션 |
| 크라프트지 | --theme magazine-kraft | kraft-archive | 송조체 본문 + archive 제목 상자, 아카이브 스타일 인용, 로마 숫자 순서 목록, 오래된 종이 코드 프레임 |
| 듄 | --theme magazine-dune | dune-gallery | Avenir 본문 + 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-paper | zhijian | 브랜드 교안: 따뜻한 테라코타 세로선 제목, 먹물 블루 3단계 제목, Human Accent 인용, 따뜻한 검정 코드 블록 |
kami-document | kami | 종이 감성 문서: 격식 있고 절제된, 제목 왼쪽 ink-blue 세로선 |
magazine-editorial | magazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune | 전자 잡지 패밀리: magazine_variant를 통해 classic / research / fieldnote / archive / gallery 5가지 레이아웃 각각 표현 |
elegant-essay | elegant | 복고풍 장문: 중앙 정렬 제목, 여유로운 줄 간격, 발췌식 인용 |
modern-technical | modern | 현대 튜토리얼: 산세리프 계층, 팁 카드, 기술 코드 블록 |
minimal-notes | minimal | 미니멀 노트: 낮은 장식, 넉넉한 여백, 가는 선 인용 |
공식 계정 호환 하드 규칙: 모든 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
출력 내용:
- 완전한 HTML 파일
- 인라인 스타일 (공식 계정에 바로 복사 가능)
- 이미지 링크 유지
- 코드 블록, 인용 블록, 목록 등 자동 처리
작업 흐름
-
Markdown 파일 읽기
- frontmatter 파싱 (제목, 요약 등)
- 본문 내용 추출
-
테마 설정 로드
- 테마 매개변수 읽기
- 사용자 정의 매개변수 적용
-
HTML로 변환
- Markdown → HTML 구조
- 테마 스타일 적용 (인라인)
- 특수 요소 처리 (코드, 이미지, 인용)
-
파일 출력
- 완전한 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은 브라우저에서 열어 볼 수 있습니다.
새 테마 확장
단계:
-
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' -
새 테마 사용:
/wechat-styler article.md --theme my-theme
공식 계정 호환 하드 규칙
다음 규칙은 scripts/validate.mjs에 의해 결정론적으로 실행되며, 모델의 자의식에 의존하지 않습니다. 변환 산출물은 자동으로 검증됩니다. node scripts/validate.mjs output.html을 독립적으로 실행하여 재확인할 수 있습니다 (오류 없으면 0으로 종료, 오류 있으면 1로 종료, CI/자동화용).
변환은 소프트 게이트 전략을 사용합니다. ERROR 발견 시 파일은 정상적으로 생성되지만 (사용자가 먼저 효과를 볼 수 있음), 마지막에 빨간색 오류 보고서 세부 사항을 출력합니다. 독립 실행형 validate 스크립트만 0이 아닌 종료 코드를 반환합니다.
ERROR 레벨 (산출물에 반드시 0이어야 함, 그렇지 않으면 붙여넣기 후 문제 발생)
- 금지 태그:
<style>/<script>/<link>/<iframe>/ body 내<meta>/<input>- 이유: 공식 계정 편집기가 제거하여 스타일/스크립트/외부 리소스가 무효화됨
- 금지 속성:
class=/id=/contenteditable- 이유: 공식 계정 편집기가 제거, 스타일은 모두
style에 인라인으로 있어야 함
- 이유: 공식 계정 편집기가 제거, 스타일은 모두
- 금지 CSS:
position:fixed|absolute/display:grid|flex/@media/@keyframes- 이유: 붙여넣기 후 위치 오류, 레이아웃 붕괴 또는 무시됨
- 금지 함수:
rgba()/hsla()- 이유: 배경색이 편집기에서 손실되므로 solid hex를 사용해야 함 (예:
#1B365D,rgba(27,54,93,0.8)아님)
- 이유: 배경색이 편집기에서 손실되므로 solid hex를 사용해야 함 (예:
- 금지 외부 글꼴:
@font-face의url(...)외부 참조- 이유: 로드 실패 시 폴백, 레이아웃 변형; 시스템 글꼴 스택 사용
WARN 레벨 (수정 권장, 차단하지 않음)
- 이미지에 alt 없음:
<img>에alt속성 누락 (접근성 + 이미지 호스트 장애 시 폴백) - 이미지 오프셋 위험:
<img>에margin:0 auto또는display:block누락 (붙여넣기 후 왼쪽으로 치우칠 수 있음) - 블록 요소에 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】를 로 바꾸면 됩니다.
한 줄을 차지하는 【삽입:xxx】(전각 대괄호)만 지원합니다. 인라인에서는 트리거되지 않아 본문 오인식을 방지합니다.
예시
입력 Markdown:
---
title: 글 제목
summary: 글 요약
---
## 섹션 제목
본문입니다.**굵게** 및 `코드`를 포함합니다.

> 인용문입니다.
출력 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 저자: 大鹏
