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.

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.yamly 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.
| Tema | Comando | Variante | Personalidad tipográfica / de maquetación |
|---|---|---|---|
| Tinta clásica | --theme magazine-ink | ink-classic | Cuerpo sans-serif + títulos serif, regla fina, lista con guiones, cita destacada, estilo revista general |
| Índigo porcelana | --theme magazine-indigo | indigo-research | Cuerpo Inter/SF Pro + títulos Source Serif, barra de investigación izquierda, nota-cita, bloques de código técnico |
| Tinta bosque | --theme magazine-forest | forest-fieldnote | Cuerpo 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-kraft | kraft-archive | Cuerpo 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-dune | dune-gallery | Cuerpo 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 demagazine_variantsiguen diferentes ramas estructurales, no solo reemplazan colores. - Todos los colores de fondo usan hex sólido y se redeclaran
background-coloren 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 autocomo 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.
| Ajuste | Tema vinculado | Tono de maquetación |
|---|---|---|
zhijian-warm-paper | zhijian | Apuntes 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-document | kami | Documento con textura de papel: formal, sobrio, títulos con línea vertical azul tinta a la izquierda |
magazine-editorial | magazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune | Familia de revista electrónica: a través de magazine_variant se presentan cinco estilos: classic / research / fieldnote / archive / gallery |
elegant-essay | elegant | Ensayo extenso retro: títulos centrados, interlineado amplio, citas extractadas |
modern-technical | modern | Tutorial moderno: jerarquía sans-serif, tarjetas de consejos, bloques de código técnico |
minimal-notes | minimal | Notas 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ámetro | Descripción | Valor por defecto |
|---|---|---|
--theme | Nombre del tema | zhijian |
--font-size | Tamaño de fuente del cuerpo (px) | 17 |
--line-height | Interlineado | 1.58 |
--accent-color | Color de énfasis (títulos, enlaces) | #B85235 |
--background-color | Color de fondo, debe ser hex sólido | #F5F4ED |
--max-width | Ancho máximo del contenido (px) | 640 |
--output | Ruta del archivo de salida | Generado automáticamente |
Reglas de salida
Ruta de salida por defecto:
- Entrada:
ruta/al/articulo.md - Salida:
ruta/al/articulo_wechat.html
Contenido de salida:
- Archivo HTML completo
- Estilos en línea (listo para copiar en la cuenta oficial)
- Se conservan los enlaces a imágenes
- Gestión automática de bloques de código, bloques de cita, listas, etc.
Flujo de trabajo
-
Lectura del archivo Markdown
- Analiza el frontmatter (título, resumen, etc.)
- Extrae el contenido del cuerpo
-
Carga de la configuración del tema
- Lee los parámetros del tema
- Aplica los parámetros personalizados del usuario
-
Conversión a HTML
- Markdown → estructura HTML
- Aplica los estilos del tema (en línea)
- Procesa elementos especiales (código, imágenes, citas)
-
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:
-
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' -
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)
- 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
- Atributos prohibidos:
class=/id=/contenteditable- Motivo: el editor de la cuenta oficial los elimina, los estilos deben estar completamente en línea en
style
- Motivo: el editor de la cuenta oficial los elimina, los estilos deben estar completamente en línea en
- CSS prohibido:
position:fixed|absolute/display:grid|flex/@media/@keyframes- Motivo: al pegar, se descolocan, el layout se rompe o se ignoran
- Funciones prohibidas:
rgba()/hsla()- Motivo: los colores de fondo se pierden en el editor, se debe usar hex sólido (ej.
#1B365D, norgba(27,54,93,0.8))
- Motivo: los colores de fondo se pierden en el editor, se debe usar hex sólido (ej.
- 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)
- Imagen sin alt:
<img>sin atributoalt(accesibilidad + fallback cuando el alojamiento de imágenes falla) - Riesgo de desplazamiento de imagen:
<img>sinmargin:0 autoodisplay:block(al pegar puede quedar alineada a la izquierda) - Elemento de bloque sin style:
<p>/<h2>/<blockquote>sin atributostyle(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-coloren tres capas para reducir la pérdida de fondo al pegar - Doble fallback para imágenes:
text-align:centeren el padre +margin:0 auto;display:blocken 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 .
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`.

> 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
