WeChat Styler - Ferramenta de Formatação para WeChat Official Account
Converta artigos em Markdown em HTML elegante e pronto para o WeChat Official Account, com suporte a múltiplos temas.
Pré-visualização do Resultado
Gerado a partir de um trecho real do documento WorkBuddy capturado em 2026-06-30. À esquerda, o Markdown original; à direita, a saída com o tema zhijian.

Como Usar
# Uso básico (com o tema padrão)
/wechat-styler caminho/para/artigo.md
# Especificar um tema
/wechat-styler caminho/para/artigo.md --theme kami
/wechat-styler caminho/para/artigo.md --theme magazine-ink
# Conversão em lote (com suporte a glob)
/wechat-styler "artigos/*.md" --theme kami
/wechat-styler "01_Projeto/criacao-conteudo/**/*.md" --theme magazine-ink
# Parâmetros personalizados
/wechat-styler caminho/para/artigo.md --theme kami --font-size 17 --accent-color "#1B365D"
# Salvar em um caminho específico (arquivo único)
/wechat-styler caminho/para/artigo.md --output caminho/para/saida.html
Temas Disponíveis
0. zhijian (Tema da Marca Zhijian AI) - Tema Padrão
Aviso de Código Aberto: Este é um tema de marca de exemplo, demonstrando como incorporar um sistema de marca (cores + fontes + personalidade tipográfica) em uma skill. Ele vem do sistema de design de marca do próprio autor. Você pode usá-lo diretamente ou usar sua estrutura como referência para modificar
themes/zhijian.yamle criar seu próprio tema de marca (mudando cores, fontes e rótulo superior).
Características:
- Baseado no sistema de marca DESIGN.md: sensação de papel quente × credibilidade de consultor
- Fundo com textura de papel
#F5F4ED, cor de ação em terracota escura#B85235, cor estrutural azul-tinta#1B365D - Estratégia de três camadas de fonte: título em KaiTi (sensação de marca), corpo em SongTi (legibilidade), UI em HeiTi (funcionalidade)
- Linha vertical em terracota à esquerda do H2, H3 em azul-tinta, linha esquerda Human Accent para citações em bloco
- Bloco de código com fundo preto quente e borda arredondada de 12px, código inline em azul-tinta com fundo azul claro
- Negrito e links usam
#A04A2E(cor quente segura WCAG AA) - Linha divisória em terracota, curta e centralizada
Cenários de uso: Todo o conteúdo da marca Zhijian AI — artigos no WeChat Official Account, materiais de treinamento, conteúdo de cursos, compartilhamento de metodologias, casos de implementação de IA
Parâmetros:
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'
secondary_accent: '#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 (Edição e Diagramação em Papel)
Características:
- Fundo com textura de pergaminho quente:
#f5f4ed - Cor de destaque única em azul-tinta:
#1B365D - Títulos em chinês usam pilha de serifa/KaiTi, corpo usa pilha de sans-serif estável
- Tons de cinza quentes, sem usar cinza frio ou fundo branco puro e grande
- Linha vertical azul à esquerda do título, fundo de tag sólido, bloco de citação contido
- Todas as cores de fundo usam hex sólido, repetidas nas camadas externa, de conteúdo e de texto para reduzir o risco de perda de fundo ao colar no WeChat
Cenários de uso: Artigos aprofundados no WeChat Official Account, análises de negócios, conteúdo de cursos, textos formais explicativos
Parâmetros:
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. Série magazine (Revista Eletrônica × Tinta Eletrônica)
Migrado de magazine-web-ppt, mantém as relações de cor de revista de ink / paper / tint, mas adaptado para HTML seguro do WeChat Official Account: não usa rgba(), todas as cores de fundo são hex sólido.
| Tema | Comando | Variante | Personalidade da Fonte / Tipografia |
|---|---|---|---|
| Tinta Clássica | --theme magazine-ink | ink-classic | Corpo em sans-serif + título em serifa, regras finas, lista com traço, citação destacada, página geral de revista |
| Índigo Porcelana | --theme magazine-indigo | indigo-research | Corpo em Inter/SF Pro + título em Source Serif, barra de pesquisa à esquerda, citação de nota, bloco de código técnico |
| Floresta Tinta | --theme magazine-forest | forest-fieldnote | Corpo em KaiTi/SongTi + título não-ficcional, título centralizado, citação de nota de campo, legenda de imagem natural |
| Kraft | --theme magazine-kraft | kraft-archive | Corpo em SongTi + caixa de título de arquivo, citação de arquivo, lista ordenada com números romanos, bloco de código em papel envelhecido |
| Duna | --theme magazine-dune | dune-gallery | Corpo em Avenir + título em Didot/Bodoni, título de galeria alinhado à direita, citação de galeria, legenda de imagem minimalista |
Características comuns:
- Cada tema tem pilha de fonte, tamanho de fonte, altura de linha, espaçamento entre parágrafos, estrutura de título, marcador de lista, bloco de citação, bloco de código e legenda de imagem independentes.
- Separação é feita com espaço em branco, linhas curtas e sutis e marcadores locais; não insere automaticamente linhas sólidas de largura total entre cada seção.
- Os cinco temas compartilham a entrada do renderizador
magazine-editorial, mas usam diferentes ramos estruturais através demagazine_variant, não apenas substituindo cores. - Todas as cores de fundo usam hex sólido e repetem
background-colornos spans de bloco e texto para reduzir a chance de perda de cor de fundo ao copiar para o editor do WeChat Official Account. - As imagens têm
margin:0 autocentralizado como fallback para evitar que o editor do WeChat Official Account reescreva a largura da imagem e a coloque à esquerda. - A diagramação mantém a sensação de revista, mas a saída é totalmente inline e pode ser copiada diretamente para o editor do WeChat Official Account.
3. elegant (Elegante Retrô)
Características:
- Chinês: FZShuSong-Z01
- Inglês: Garamond
- Fundo cinza claro geral
- Sistema de cor de destaque vermelha
- Título em serifa + código monoespaçado
Cenários de uso: Casos de negócios, análises aprofundadas, compartilhamento de conhecimento
Parâmetros:
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 (Moderno e Minimalista)
Características:
- Fonte sans-serif
- Fundo branco puro
- Cor de destaque azul
- Moderno e claro
Cenários de uso: Produtos de tecnologia, tutoriais, notícias rápidas
Parâmetros:
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 (Minimalista)
Características:
- Preto e branco minimalista
- Muito espaço em branco
- Tom cinza
- Elegante e contido
Cenários de uso: Reflexões filosóficas, ensaios pessoais, crítica de arte
Parâmetros:
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
Presets do Renderizador
Os temas não se limitam a trocar cores. Cada tema está vinculado a uma personalidade de renderização Markdown que controla a estrutura, tamanho da fonte, altura da linha, espaçamento e peso da fonte para títulos, corpo, citações, listas, código e legendas de imagem.
| Preset | Temas Vinculados | Tom Tipográfico |
|---|---|---|
zhijian-warm-paper | zhijian | Material de marca: título com linha vertical em terracota, título terciário em azul-tinta, citação Human Accent, bloco de código preto quente |
kami-document | kami | Documento em papel: formal, contido, linha vertical azul-tinta à esquerda do título |
magazine-editorial | magazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune | Família de revista eletrônica: através de magazine_variant, exibe cinco diagramações: classic / research / fieldnote / archive / gallery |
elegant-essay | elegant | Texto longo retrô: título centralizado, altura de linha confortável, citação em formato de extrato |
modern-technical | modern | Tutorial moderno: hierarquia sans-serif, cartão de dica, bloco de código técnico |
minimal-notes | minimal | Notas minimalistas: baixa decoração, muito espaço em branco, citação com linha fina |
Regras rígidas de compatibilidade com WeChat Official Account: Todas as saídas de preset são inline style; cores de fundo usam hex sólido; a seção externa, a seção de conteúdo e o span de texto declaram background-color repetidamente.
Descrição dos Parâmetros do Tema
| Parâmetro | Descrição | Valor Padrão |
|---|---|---|
--theme | Nome do tema | zhijian |
--font-size | Tamanho da fonte do corpo (px) | 17 |
--line-height | Altura da linha | 1.58 |
--accent-color | Cor de destaque (títulos, links) | #B85235 |
--background-color | Cor de fundo, deve usar hex sólido | #F5F4ED |
--max-width | Largura máxima do conteúdo (px) | 640 |
--output | Caminho do arquivo de saída | Gerado automaticamente |
Regras de Saída
Caminho de saída padrão:
- Entrada:
caminho/para/artigo.md - Saída:
caminho/para/artigo_wechat.html
Conteúdo da saída:
- Arquivo HTML completo
- Estilos inline (prontos para copiar para o WeChat Official Account)
- Links de imagem preservados
- Processamento automático de blocos de código, citações, listas, etc.
Fluxo de Trabalho
-
Ler arquivo Markdown
- Analisar frontmatter (título, resumo, etc.)
- Extrair conteúdo do corpo
-
Carregar configuração do tema
- Ler parâmetros do tema
- Aplicar parâmetros personalizados do usuário
-
Converter para HTML
- Markdown → estrutura HTML
- Aplicar estilos do tema (inline)
- Processar elementos especiais (código, imagens, citações)
-
Salvar arquivo
- Gerar HTML completo
- Salvar no caminho especificado
- Exibir instruções de uso
Pré-visualização dos Temas
Não sabe qual tema escolher? Use o gerador de pré-visualização de temas para comparar todos os temas:
# Gerar página de pré-visualização para todos os temas (usando artigo de exemplo padrão)
node scripts/generate-preview.mjs
# Gerar pré-visualização com um artigo personalizado
node scripts/generate-preview.mjs caminho/para/seu-artigo.md
# Pré-visualizar apenas temas específicos (separados por vírgula, sem espaços)
node scripts/generate-preview.mjs artigo.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune
# Caminho de saída personalizado
node scripts/generate-preview.mjs artigo.md --themes kami,elegant --output /caminho/para/minha-preview.html
A página de pré-visualização exibirá os efeitos dos temas selecionados lado a lado, facilitando a comparação e escolha rápida. O arquivo preview.html gerado pode ser aberto em um navegador.
Estendendo com Novos Temas
Passos:
-
Crie um novo arquivo de configuração de tema no diretório
themes/:# themes/meu-tema.yaml name: meu-tema description: Meu tema personalizado 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' -
Use o novo tema:
/wechat-styler artigo.md --theme meu-tema
Regras Rígidas de Compatibilidade com WeChat Official Account
As seguintes regras são deterministicamente executadas por scripts/validate.mjs, sem depender da boa vontade do modelo. A saída do convert é automaticamente validada; executar node scripts/validate.mjs output.html independentemente pode refazer a validação (0 ERROR sai com código 0, ERROR sai com código 1, para uso em CI/automação).
O convert usa uma estratégia de porta suave: quando um ERROR é encontrado, o arquivo ainda é gerado (para o usuário ver o resultado primeiro), mas um relatório detalhado em vermelho é impresso no final; apenas o script de validação independente retorna código de saída diferente de zero.
Nível ERROR (o resultado deve ter 0; caso contrário, problemas após colar)
- Tags proibidas:
<style>/<script>/<link>/<iframe>/<meta>(dentro de ) /<input>- Motivo: o editor do WeChat Official Account as remove, fazendo com que estilos/scripts/recursos externos não funcionem
- Atributos proibidos:
class=/id=/contenteditable- Motivo: o editor do WeChat Official Account os remove; estilos devem ser totalmente inline via
style
- Motivo: o editor do WeChat Official Account os remove; estilos devem ser totalmente inline via
- CSS proibido:
position:fixed|absolute/display:grid|flex/@media/@keyframes- Motivo: após colar, ocorrem desalinhamento, colapso de layout ou são ignorados
- Funções proibidas:
rgba()/hsla()- Motivo: a cor de fundo é perdida no editor; deve-se usar hex sólido (ex.:
#1B365D, nãorgba(27,54,93,0.8))
- Motivo: a cor de fundo é perdida no editor; deve-se usar hex sólido (ex.:
- Fontes externas proibidas: referência
url(...)em@font-face- Motivo: falha de carregamento com fallback, layout distorcido; use pilha de fontes do sistema
Nível WARN (recomendado corrigir, não bloqueia)
- Imagem sem alt:
<img>sem atributoalt(acessibilidade + fallback quando o servidor de imagens falha) - Risco de desalinhamento de imagem:
<img>semmargin:0 autooudisplay:block(pode ficar alinhado à esquerda após colar) - Elemento de bloco sem style:
<p>/<h2>/<blockquote>sem atributostyle(estilo perdido após colar)
Estratégias de compatibilidade já incorporadas no convert.mjs (sem necessidade de ação manual)
- Todas as cores de fundo usam hex sólido, não
rgba() - Três camadas (seção externa / seção de conteúdo / span de texto) declaram
background-colorrepetidamente para reduzir a perda de fundo após colar - Imagem:
text-align:centerno pai +margin:0 auto;display:blocknela mesma, duplo fallback para evitar desalinhamento - Todos os estilos são inline; não usa tags
<style>ou CSS externo
Mecanismo de Placeholder
Ainda não preparou o servidor de imagens, mas quer ver o efeito da diagramação? Escreva placeholders no Markdown; o convert os renderizará como caixas cinzas tracejadas centralizadas:
Aqui está um parágrafo do texto.
【inserir: captura de tela do início do vídeo】
O texto continua.
Efeito de renderização: caixa tracejada cinza neutra contida + texto cinza centralizado "📷 Aguardando material: xxx", sem roubar a cena do texto principal. Quando a imagem estiver pronta, substitua 【inserir:xxx】 por .
Suporta apenas 【inserir:xxx】 em linha própria (colchetes largos de largura total); não aciona inline, para não afetar o texto do corpo acidentalmente.
Exemplo
Markdown de Entrada:
---
title: Título do Artigo
summary: Resumo do Artigo
---
## Título da Seção
Aqui está o corpo do texto, contendo **negrito** e `código`.

> Esta é uma citação
HTML de Saída:
- HTML completo e utilizável no WeChat Official Account
- Todos os estilos inline
- Pronto para copiar e colar
Implementação Técnica
Scripts principais: scripts/convert.mjs (conversão) + scripts/validate.mjs (validação de compatibilidade com WeChat Official Account)
Dependências:
- Node.js 18+
- marked (análise de Markdown)
- js-yaml (análise de YAML)
Estrutura de Diretórios:
wechat-styler/
├── SKILL.md
├── scripts/
│ ├── convert.mjs # Markdown → HTML do WeChat Official Account (chama validate com porta suave)
│ ├── validate.mjs # Validação de compatibilidade com WeChat Official Account (executável independentemente / referenciado pelo convert)
│ └── generate-preview.mjs # Gerador de página de pré-visualização de temas
├── 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
Última atualização: 2026-07-07 Versão: 1.4.0 Autor: Dapeng
