Communitygithub.com

wechat-styler

Convierte Markdown en HTML con estilos en línea listo para pegar en artículos de cuentas oficiales de WeChat. 10 temas, validación determinista y soporte de marcadores de posición.

¿Qué es wechat-styler?

WeChat Styler es una herramienta para desarrolladores y creadores de contenido que transforma documentos Markdown en HTML con estilos en línea, optimizado para el editor de artículos de cuentas oficiales de WeChat (WeChat Official Account / 公众号). A diferencia de soluciones que generan CSS externo o usan `rgba()` —que el editor de WeChat descarta—, este skill aplica reglas estrictas de compatibilidad: todos los estilos son en línea, los colores de fondo usan valores hex sólidos, y se evitan propiedades como `flex` o `position: absolute`. Soporta 10 temas predefinidos (como 'zhijian', 'kami', 'magazine-ink', 'elegant', 'modern', 'minimal'), cada uno con su propia personalidad tipográfica y paleta de colores. Incluye un validador determinista (`validate.mjs`) que detecta errores críticos (etiquetas no permitidas, colores no sólidos) y advertencias (imágenes sin `alt`, sin `margin: 0 auto`). Además, ofrece un mecanismo de marcadores de posición (`【Insertar:descripción】`) que permite previsualizar el diseño antes de tener las imágenes finales. Funciona como un skill para asistentes de IA (Claude Code, Cursor, etc.) y también como scripts CLI independientes (`node scripts/convert.mjs` y `node scripts/validate.mjs`), lo que lo hace integrable en flujos de CI/CD.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Vista previa de WeChat Styler en paralelo
alt
Pie de foto

Documentación

WeChat Styler - Herramienta de maquetación para cuentas oficiales de WeChat

Convierte artículos en Markdown a HTML elegante para cuentas oficiales de WeChat, con soporte para múltiples temas.

Vista previa del resultado

Generado a partir de un fragmento real del documento WorkBuddy capturado el 2026-06-30. A la izquierda el Markdown original, a la derecha la salida con el tema zhijian.

Vista previa de WeChat Styler en paralelo

Modo de uso

# Uso básico (con el tema por defecto)
/wechat-styler ruta/al/articulo.md

# Especificar un tema
/wechat-styler ruta/al/articulo.md --theme kami
/wechat-styler ruta/al/articulo.md --theme magazine-ink

# Conversión por lotes (soporta patrones glob)
/wechat-styler "articulos/*.md" --theme kami
/wechat-styler "01_Proyecto/creacion-contenido/**/*.md" --theme magazine-ink

# Parámetros personalizados
/wechat-styler ruta/al/articulo.md --theme kami --font-size 17 --accent-color "#1B365D"

# Especificar ruta de salida (archivo único)
/wechat-styler ruta/al/articulo.md --output ruta/de/salida.html

Temas disponibles

0. zhijian (tema de la marca Zhijian AI) - Tema por defecto

Aviso de código abierto: Este es un tema de marca de ejemplo que muestra cómo integrar un sistema de marca completo (colores + fuentes + personalidad tipográfica) en un skill. Proviene del propio sistema de diseño del autor. Puedes usarlo directamente o inspirarte en su estructura para modificar themes/zhijian.yaml y crear tu propio tema (cambiando colores, fuentes y top_label).

Características:

  • Basado en el sistema de marca de DESIGN.md: sensación de papel cálido × credibilidad de consultor
  • Fondo con textura de papel #F5F4ED, color de acción en terracota oscuro #B85235, color estructural azul tinta #1B365D
  • Estrategia tipográfica de tres niveles: títulos en cursiva (toque de marca), cuerpo en Song (legibilidad), UI en sans-serif (funcionalidad)
  • Línea vertical terracota a la izquierda de H2, color azul tinta para H3, línea izquierda Human Accent en citas
  • Bloques de código con fondo negro cálido y bordes redondeados de 12px, código en línea con fondo azul claro y texto azul tinta
  • Negritas y enlaces usan #A04A2E (color cálido seguro para WCAG AA)
  • Separadores con líneas cortas centradas en color terracota

Adecuado para: Todo el contenido de la marca Zhijian AI — artículos de cuenta oficial, materiales de formación, contenido de cursos, intercambio de metodologías, casos prácticos de implementación 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'
accent_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 (Maquetación con textura de papel)

Características:

  • Fondo con textura de pergamino cálido: #f5f4ed
  • Color de énfasis único en azul tinta: #1B365D
  • Títulos en chino con pila serif/cursiva, cuerpo con pila sans-serif estable
  • Gamas de grises cálidas, sin usar grises fríos ni fondos blancos puros
  • Línea vertical azul a la izquierda de los títulos, fondo sólido en tags, citas sobrias
  • Todos los fondos usan colores hex sólidos y se redeclaran en las capas exterior, de contenido y de texto para minimizar la pérdida de fondo al pegar en la cuenta oficial

Adecuado para: Artículos de fondo en cuentas oficiales, análisis de negocio, contenido de cursos, textos explicativos formales

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. Serie magazine (Revista electrónica × Tinta electrónica)

Migrada de magazine-web-ppt, conserva 5 ajustes predefinidos que mantienen la relación cromática de revista ink / paper / tint, pero adaptados a HTML seguro para cuentas oficiales de WeChat: no usa rgba(), todos los fondos son hex sólidos.

TemaComandoVariantePersonalidad tipográfica / de maquetación
Tinta clásica--theme magazine-inkink-classicCuerpo sans-serif + títulos serif, regla fina, lista con guiones, cita destacada, estilo revista general
Índigo porcelana--theme magazine-indigoindigo-researchCuerpo Inter/SF Pro + títulos Source Serif, barra de investigación izquierda, nota-cita, bloques de código técnico
Tinta bosque--theme magazine-forestforest-fieldnoteCuerpo en cursiva/Song + títulos de no ficción, títulos centrados, cita de nota de campo, pies de foto naturales
Papel kraft--theme magazine-kraftkraft-archiveCuerpo en Song + caja de título de archivo, cita archivística, listas ordenadas con números romanos, cuadro de código en papel envejecido
Dunas--theme magazine-dunedune-galleryCuerpo Avenir + títulos Didot/Bodoni, título de galería alineado a la derecha, cita de galería, pies de foto minimalistas

Características comunes:

  • Cada tema tiene su propia pila de fuentes, tamaño de letra, interlineado, espaciado entre párrafos, estructura de títulos, marcadores de lista, bloques de cita, bloques de código y pies de foto.
  • La separación se basa en espacio en blanco, líneas cortas y tenues, y marcas locales; no se insertan automáticamente líneas sólidas de ancho completo entre cada sección.
  • Los cinco temas comparten la entrada del renderizador magazine-editorial, pero a través de magazine_variant siguen diferentes ramas estructurales, no solo reemplazan colores.
  • Todos los colores de fondo usan hex sólido y se redeclaran background-color en los bloques y en los spans de texto para reducir la probabilidad de perder el fondo al copiar en el editor de la cuenta oficial.
  • Las imágenes llevan margin:0 auto como fallback de centrado para evitar que el editor de la cuenta oficial modifique el ancho de la imagen y la desplace a la izquierda.
  • La maquetación conserva la sensación de revista, pero la salida sigue siendo totalmente en línea, lista para copiar y pegar en el editor de la cuenta oficial.

3. elegant (Elegante y retro)

Características:

  • Chino: FZShuSong-Z01 (Fangzheng Shusong)
  • Inglés: Garamond
  • Fondo gris claro general
  • Sistema de color de énfasis rojo
  • Títulos serif + código monoespaciado

Adecuado para: Casos de negocio, análisis en profundidad, intercambio de conocimientos

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 y minimalista)

Características:

  • Fuente sans-serif
  • Fondo blanco puro
  • Color de énfasis azul
  • Limpio y moderno

Adecuado para: Productos tecnológicos, tutoriales, noticias breves

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:

  • Blanco y negro minimalista
  • Mucho espacio en blanco
  • Tonos grises
  • Sobrio y elegante

Adecuado para: Reflexiones filosóficas, ensayos personales, 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

Ajustes preestablecidos del renderizador

Los temas no solo cambian colores. Cada tema tiene una personalidad de renderizado Markdown que define la estructura, tamaño de fuente, interlineado, espaciado y peso de la fuente para títulos, cuerpo, citas, listas, código y pies de foto.

AjusteTema vinculadoTono de maquetación
zhijian-warm-paperzhijianApuntes de marca: títulos con línea vertical terracota, títulos de tercer nivel en azul tinta, citas Human Accent, bloques de código en negro cálido
kami-documentkamiDocumento con textura de papel: formal, sobrio, títulos con línea vertical azul tinta a la izquierda
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-duneFamilia de revista electrónica: a través de magazine_variant se presentan cinco estilos: classic / research / fieldnote / archive / gallery
elegant-essayelegantEnsayo extenso retro: títulos centrados, interlineado amplio, citas extractadas
modern-technicalmodernTutorial moderno: jerarquía sans-serif, tarjetas de consejos, bloques de código técnico
minimal-notesminimalNotas minimalistas: poca decoración, mucho espacio en blanco, citas con línea fina

Reglas estrictas de compatibilidad con WeChat: Todos los ajustes generan estilos en línea; los colores de fondo usan hex sólido; la sección exterior, la sección de contenido y los spans de texto redeclaran background-color.

Parámetros del tema

ParámetroDescripciónValor por defecto
--themeNombre del temazhijian
--font-sizeTamaño de fuente del cuerpo (px)17
--line-heightInterlineado1.58
--accent-colorColor de énfasis (títulos, enlaces)#B85235
--background-colorColor de fondo, debe ser hex sólido#F5F4ED
--max-widthAncho máximo del contenido (px)640
--outputRuta del archivo de salidaGenerado automáticamente

Reglas de salida

Ruta de salida por defecto:

  • Entrada: ruta/al/articulo.md
  • Salida: ruta/al/articulo_wechat.html

Contenido de salida:

  1. Archivo HTML completo
  2. Estilos en línea (listo para copiar en la cuenta oficial)
  3. Se conservan los enlaces a imágenes
  4. Gestión automática de bloques de código, bloques de cita, listas, etc.

Flujo de trabajo

  1. Lectura del archivo Markdown

    • Analiza el frontmatter (título, resumen, etc.)
    • Extrae el contenido del cuerpo
  2. Carga de la configuración del tema

    • Lee los parámetros del tema
    • Aplica los parámetros personalizados del usuario
  3. Conversión a HTML

    • Markdown → estructura HTML
    • Aplica los estilos del tema (en línea)
    • Procesa elementos especiales (código, imágenes, citas)
  4. Archivo de salida

    • Genera el HTML completo
    • Guarda en la ruta especificada
    • Muestra instrucciones de uso

Vista previa de temas

¿No sabes qué tema elegir? Usa el generador de vista previa para comparar todos los temas:

# Genera una página de vista previa de todos los temas (con un artículo de ejemplo por defecto)
node scripts/generate-preview.mjs

# Genera una vista previa con tu propio artículo
node scripts/generate-preview.mjs ruta/a/tu-articulo.md

# Vista previa solo de temas específicos (separados por comas, sin espacios)
node scripts/generate-preview.mjs articulo.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# Ruta de salida personalizada
node scripts/generate-preview.mjs articulo.md --themes kami,elegant --output /ruta/a/mi-preview.html

La página de vista previa mostrará los temas seleccionados en paralelo, facilitando la comparación visual. El archivo preview.html generado se puede abrir en un navegador.

Cómo añadir un nuevo tema

Pasos:

  1. Crea un archivo de configuración del nuevo tema en el directorio themes/:

    # themes/mi-tema.yaml
    name: mi-tema
    description: Mi 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. Usa el nuevo tema:

    /wechat-styler articulo.md --theme mi-tema
    

Reglas estrictas de compatibilidad con WeChat

Las siguientes reglas son ejecutadas de forma determinista por scripts/validate.mjs, sin depender de la conciencia del modelo. Los productos de convert se validan automáticamente; ejecutando node scripts/validate.mjs output.html de forma independiente se puede volver a comprobar (0 ERROR sale con 0, con ERROR sale con 1, para usar en CI/automatizaciones).

convert utiliza una estrategia de puerta blanda: si se encuentra un ERROR, el archivo se genera de todas formas (el usuario puede ver el resultado primero) y al final se imprime un informe detallado en rojo; solo el script de validación independiente devuelve un código de salida distinto de cero.

Nivel ERROR (el producto debe tener 0, de lo contrario causará problemas al pegar)

  1. Etiquetas prohibidas: <style> / <script> / <link> / <iframe> / <meta> dentro del body / <input>
    • Motivo: el editor de la cuenta oficial las elimina, haciendo que los estilos/scripts/recursos externos no funcionen
  2. Atributos prohibidos: class= / id= / contenteditable
    • Motivo: el editor de la cuenta oficial los elimina, los estilos deben estar completamente en línea en style
  3. CSS prohibido: position:fixed|absolute / display:grid|flex / @media / @keyframes
    • Motivo: al pegar, se descolocan, el layout se rompe o se ignoran
  4. Funciones prohibidas: rgba() / hsla()
    • Motivo: los colores de fondo se pierden en el editor, se debe usar hex sólido (ej. #1B365D, no rgba(27,54,93,0.8))
  5. Fuentes externas prohibidas: referencias externas url(...) en @font-face
    • Motivo: falla la carga y se degrada, la maquetación se distorsiona; usar pilas de fuentes del sistema

Nivel WARN (se recomienda corregir, no bloquea)

  1. Imagen sin alt: <img> sin atributo alt (accesibilidad + fallback cuando el alojamiento de imágenes falla)
  2. Riesgo de desplazamiento de imagen: <img> sin margin:0 auto o display:block (al pegar puede quedar alineada a la izquierda)
  3. Elemento de bloque sin style: <p> / <h2> / <blockquote> sin atributo style (al pegar se pierden los estilos)

Estrategias de compatibilidad ya integradas en convert.mjs (no requieren manipulación manual)

  • Todos los colores de fondo usan hex sólido, no rgba()
  • La sección exterior / sección de contenido / span de texto redeclaran background-color en tres capas para reducir la pérdida de fondo al pegar
  • Doble fallback para imágenes: text-align:center en el padre + margin:0 auto;display:block en la propia imagen, evitando desplazamientos
  • Todos los estilos están en línea, sin usar etiquetas <style> ni CSS externo

Mecanismo de marcadores de posición

¿El alojamiento de imágenes aún no está listo pero quieres ver el efecto de maquetación? Escribe marcadores de posición en Markdown y convert los renderizará como recuadros grises punteados centrados:

Este es un párrafo.

【Insertar:captura de pantalla del video al inicio del artículo】

Continúa el párrafo.

Efecto renderizado: recuadro gris punteado sobrio y neutral + texto gris centrado "📷 Material pendiente: xxx", sin robar protagonismo al texto. Cuando la imagen esté lista, reemplaza 【Insertar:xxx】 por ![alt](url).

Solo se admiten 【Insertar:xxx】 en una línea propia (corchetes de ancho completo); no se activa en línea para evitar errores en el texto.

Ejemplo

Markdown de entrada:

---
title: Título del artículo
summary: Resumen del artículo
---

## Título de la sección

Este es un párrafo que contiene **negrita** y `código`.

![Pie de foto](https://example.com/image.png)

> Esta es una cita

HTML de salida:

  • HTML completo utilizable en la cuenta oficial
  • Todos los estilos en línea
  • Listo para copiar y pegar

Implementación técnica

Scripts principales: scripts/convert.mjs (conversión) + scripts/validate.mjs (validación de compatibilidad con WeChat)

Dependencias:

  • Node.js 18+
  • marked (análisis de Markdown)
  • js-yaml (análisis de YAML)

Estructura de directorios:

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → HTML para WeChat (llama a validate con puerta blanda)
│   ├── validate.mjs         # Validación de compatibilidad con WeChat (ejecutable independiente / llamado por convert)
│   └── generate-preview.mjs # Generador de página de vista previa 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 actualización: 2026-07-07 Versión: 1.4.0 Autor: Dapeng

Skills relacionados