Communitygithub.com

zjp1997720/wechat-styler

Converta Markdown em HTML inline estilizado pronto para colar no WeChat Official Account. 10 temas, validação determinística e suporte a placeholders.

O que é wechat-styler?

Esta skill é uma ferramenta poderosa para transformar artigos escritos em Markdown em HTML formatado e estilizado especificamente para o editor de artigos do WeChat Official Account. Ela elimina a dor de cabeça de formatar manualmente cada parágrafo, título e bloco de código, garantindo que o resultado final seja visualmente atraente e compatível com as restrições do editor do WeChat (como a necessidade de estilos inline e cores sólidas em hex, em vez de rgba). A skill oferece 10 temas diversos, que vão desde o tema padrão 'zhijian' (com tons de papel e uma paleta de cores confiável) até coleções temáticas como 'magazine' (com 5 variantes inspiradas em revistas) e opções minimalistas. O processo de conversão é determinístico: ele utiliza um script de validação rigoroso que verifica automaticamente se o HTML gerado segue as regras de compatibilidade do WeChat, como a ausência de tags `<style>`, atributos `class`, e propriedades CSS não suportadas como `rgba()`. Além disso, a skill suporta um mecanismo de placeholders (usando `【inserir: descrição】`) que permite visualizar o layout do artigo antes de ter as imagens finais, além de oferecer parâmetros para ajustar a fonte, a cor de destaque e o caminho de saída, sendo uma solução completa para criadores de conteúdo e equipes editoriais.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Pré-visualização lado a lado do WeChat Styler
alt
Legenda da Imagem

Documentação

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.

Pré-visualização lado a lado do WeChat Styler

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.yaml e 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.

TemaComandoVariantePersonalidade da Fonte / Tipografia
Tinta Clássica--theme magazine-inkink-classicCorpo 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-indigoindigo-researchCorpo 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-forestforest-fieldnoteCorpo em KaiTi/SongTi + título não-ficcional, título centralizado, citação de nota de campo, legenda de imagem natural
Kraft--theme magazine-kraftkraft-archiveCorpo 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-dunedune-galleryCorpo 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 de magazine_variant, não apenas substituindo cores.
  • Todas as cores de fundo usam hex sólido e repetem background-color nos 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 auto centralizado 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.

PresetTemas VinculadosTom Tipográfico
zhijian-warm-paperzhijianMaterial 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-documentkamiDocumento em papel: formal, contido, linha vertical azul-tinta à esquerda do título
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-duneFamília de revista eletrônica: através de magazine_variant, exibe cinco diagramações: classic / research / fieldnote / archive / gallery
elegant-essayelegantTexto longo retrô: título centralizado, altura de linha confortável, citação em formato de extrato
modern-technicalmodernTutorial moderno: hierarquia sans-serif, cartão de dica, bloco de código técnico
minimal-notesminimalNotas 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âmetroDescriçãoValor Padrão
--themeNome do temazhijian
--font-sizeTamanho da fonte do corpo (px)17
--line-heightAltura da linha1.58
--accent-colorCor de destaque (títulos, links)#B85235
--background-colorCor de fundo, deve usar hex sólido#F5F4ED
--max-widthLargura máxima do conteúdo (px)640
--outputCaminho do arquivo de saídaGerado 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:

  1. Arquivo HTML completo
  2. Estilos inline (prontos para copiar para o WeChat Official Account)
  3. Links de imagem preservados
  4. Processamento automático de blocos de código, citações, listas, etc.

Fluxo de Trabalho

  1. Ler arquivo Markdown

    • Analisar frontmatter (título, resumo, etc.)
    • Extrair conteúdo do corpo
  2. Carregar configuração do tema

    • Ler parâmetros do tema
    • Aplicar parâmetros personalizados do usuário
  3. Converter para HTML

    • Markdown → estrutura HTML
    • Aplicar estilos do tema (inline)
    • Processar elementos especiais (código, imagens, citações)
  4. 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:

  1. 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'
    
  2. 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)

  1. 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
  2. Atributos proibidos: class= / id= / contenteditable
    • Motivo: o editor do WeChat Official Account os remove; estilos devem ser totalmente inline via style
  3. CSS proibido: position:fixed|absolute / display:grid|flex / @media / @keyframes
    • Motivo: após colar, ocorrem desalinhamento, colapso de layout ou são ignorados
  4. Funções proibidas: rgba() / hsla()
    • Motivo: a cor de fundo é perdida no editor; deve-se usar hex sólido (ex.: #1B365D, não rgba(27,54,93,0.8))
  5. 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)

  1. Imagem sem alt: <img> sem atributo alt (acessibilidade + fallback quando o servidor de imagens falha)
  2. Risco de desalinhamento de imagem: <img> sem margin:0 auto ou display:block (pode ficar alinhado à esquerda após colar)
  3. Elemento de bloco sem style: <p> / <h2> / <blockquote> sem atributo style (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-color repetidamente para reduzir a perda de fundo após colar
  • Imagem: text-align:center no pai + margin:0 auto;display:block nela 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 ![alt](url).

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`.

![Legenda da Imagem](https://exemplo.com/imagem.png)

> 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

Habilidades Relacionadas