Communitygithub.com

WeChat Styler - 公众号排版工具

Transformez votre Markdown en HTML prêt à coller, avec styles en ligne, pour les articles de compte officiel WeChat. 10 thèmes, validation déterministe, support des placeholders.

Qu'est-ce que WeChat Styler - 公众号排版工具 ?

Ce skill transforme un fichier Markdown en code HTML directement compatible avec l'éditeur de compte officiel WeChat (公众号). Il convertit la structure Markdown (titres, paragraphes, citations, extraits de code, listes, images) en balises HTML avec styles en ligne. Il propose dix thèmes prédéfinis : le thème par défaut 'zhijian' (marque Zhijian AI), kami (papier parchemin), cinq thèmes 'magazine' (ink, indigo, forest, kraft, dune), elegant, modern et minimal. Chaque thème est muni d'un rendu déterministe (inline style, couleurs de fond en hexadécimal solide, largeur maximale de 640 px), ce qui garantit une copie-collé dans l'éditeur WeChat sans perte de mise en forme. Le système utilise un script de validation strict (scripts/validate.mjs) qui vérifie l'absence de balises et propriétés interdites (style, script, class, id, rgba, etc.) ; en cas d'erreur, le fichier est tout de même généré (approche 'soft gate'), mais un rapport en rouge est affiché. Des prévisualisations de tous les thèmes sont possibles et l'extension avec de nouveaux thèmes est simple via un fichier YAML dans le dossier themes/. Le skill est conçu pour des environnements comme Claude Code, Cursor, Codex, et toute interface supportant les skills autonomes.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Aperçu côte à côte de WeChat Styler
alt
Légende de l'image

Documentation

WeChat Styler - Outil de mise en page pour compte officiel WeChat

Convertissez vos articles Markdown en un format HTML élégant pour compte officiel WeChat, avec changement de thème.

Aperçu du résultat

Généré à partir d'un extrait réel du document WorkBuddy (dernière capture le 2026-06-30) : à gauche le Markdown original, à droite le rendu avec le thème zhijian.

Aperçu côte à côte de WeChat Styler

Utilisation

# Utilisation de base (thème par défaut)
/wechat-styler chemin/vers/article.md

# Spécifier un thème
/wechat-styler chemin/vers/article.md --theme kami
/wechat-styler chemin/vers/article.md --theme magazine-ink

# Conversion par lots (prend en charge les motifs glob)
/wechat-styler "articles/*.md" --theme kami
/wechat-styler "01_Projet/creation_contenu/**/*.md" --theme magazine-ink

# Paramètres personnalisés
/wechat-styler chemin/vers/article.md --theme kami --font-size 17 --accent-color "#1B365D"

# Sortie vers un chemin spécifique (fichier unique)
/wechat-styler chemin/vers/article.md --output chemin/vers/sortie.html

Thèmes disponibles

0. zhijian (thème de marque Zhijian AI) – Thème par défaut

Déclaration open source : Il s'agit d'un thème de marque d'exemple qui montre comment intégrer un système de marque complet (couleurs + polices + personnalité typographique) dans un skill. Il provient du propre système de design de l'auteur. Vous pouvez l'utiliser tel quel ou vous inspirer de sa structure pour modifier themes/zhijian.yaml afin de créer votre propre thème de marque (changez les couleurs, les polices, le top_label).

Caractéristiques :

  • Basé sur le système de marque DESIGN.md : sensation de papier chaud × crédibilité de consultant
  • Fond papier #F5F4ED, couleur d'action terre cuite foncée #B85235, couleur structurelle bleu encre #1B365D
  • Stratégie typographique à trois niveaux : titres en italic (marque), corps en Songti (lisibilité), interface en sans-serif (fonctionnalité)
  • H2 avec barre verticale terre cuite à gauche, H3 en bleu encre, bloc de citation avec accent humain à gauche
  • Bloc de code sur fond noir chaud, coins arrondis 12px, code en ligne bleu encre sur fond bleu clair
  • Gras et liens en #A04A2E (couleur chaude sécurisée WCAG AA)
  • Séparateur : courte ligne terre cuite centrée

Cas d'utilisation : Tout contenu de marque Zhijian AI – articles pour comptes officiels WeChat, supports de formation, contenus de cours, partages de méthodologie, cas concrets d'IA

Paramètres :

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'
acent_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 (Mise en page sensation papier)

Caractéristiques :

  • Fond parchemin chaud : #f5f4ed
  • Couleur d'accentuation unique bleu encre : #1B365D
  • Titres chinois en pile serif/italic, corps en pile sans-serif stable
  • Nuances de gris chaud, pas de gris froid ni de fond blanc pur
  • Titre avec barre verticale bleue à gauche, fond de tag solid, bloc de citation sobre
  • Toutes les couleurs de fond en hexadécimal solide, déclarées plusieurs fois dans la couche externe, la couche contenu et la couche texte pour réduire le risque de perte après copie dans l'éditeur WeChat

Cas d'utilisation : Articles de fond pour comptes officiels WeChat, analyses commerciales, contenus de cours, textes explicatifs formels

Paramètres :

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 (Magazine électronique × Encre électronique)

Migrée depuis magazine-web-ppt, elle conserve les relations chromatiques de magazine de ink / paper / tint tout en les adaptant au HTML sécurisé pour comptes officiels WeChat : pas de rgba(), toutes les couleurs de fond sont en hexadécimal solide.

ThèmeCommandeVariantePersonnalité police / mise en page
Encre classique--theme magazine-inkink-classicCorps sans-serif + titres serif, règle fine, liste dash, pull quote, page intérieure de magazine généraliste
Indigo--theme magazine-indigoindigo-researchCorps Inter/SF Pro + titres Source Serif, barre de recherche à gauche, note quote, blocs de code techniques
Forêt--theme magazine-forestforest-fieldnoteCorps italic/Songti + titres non-fiction, titre centré, field note citation, légendes nature
Kraft--theme magazine-kraftkraft-archiveCorps Songti + boîte titre archive, citation style archive, liste ordonnée en chiffres romains, cadre de code vieux papier
Dune--theme magazine-dunedune-galleryCorps Avenir + titres Didot/Bodoni, titre de galerie aligné à droite, gallery quote, légende minimale

Caractéristiques communes :

  • Chaque thème a sa propre pile de polices, taille de police, interligne, espacement des paragraphes, structure des titres, marqueurs de liste, bloc de citation, bloc de code et légende d'image.
  • La séparation se fait par espace blanc, lignes courtes et fines, et indicateurs locaux ; pas de ligne pleine largeur automatique entre chaque section.
  • Les cinq thèmes partagent le point d'entrée magazine-editorial renderer, mais via magazine_variant, ils utilisent différentes branches structurelles, pas seulement un changement de couleur.
  • Toutes les couleurs de fond sont en hexadécimal solide, et background-color est déclaré plusieurs fois sur les blocs et les spans de texte pour réduire le risque de perte après copie dans l'éditeur WeChat.
  • Les images ont margin:0 auto centré comme filet de sécurité, pour éviter que l'éditeur WeChat ne modifie la largeur de l'image après copie et ne la décale à gauche.
  • La mise en page conserve la sensation magazine, mais la sortie reste entièrement en ligne, prête à être copiée dans l'éditeur WeChat.

3. elegant (Élégant et rétro)

Caractéristiques :

  • Chinois : FZShuSong-Z01
  • Anglais : Garamond
  • Fond gris clair
  • Système de couleurs d'accentuation rouge
  • Titres serif + code à chasse fixe

Cas d'utilisation : Cas commerciaux, analyses approfondies, partage de connaissances

Paramètres :

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 (Moderne et minimal)

Caractéristiques :

  • Police sans-serif
  • Fond blanc pur
  • Couleur d'accentuation bleue
  • Clair et moderne

Cas d'utilisation : Produits technologiques, tutoriels, flash info

Paramètres :

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 (Minimaliste)

Caractéristiques :

  • Noir et blanc minimaliste
  • Beaucoup d'espace blanc
  • Tons gris
  • Sobriété élégante

Cas d'utilisation : Réflexions philosophiques, essais personnels, critiques d'art

Paramètres :

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

Rendu prédéfini (Render Presets)

Un thème ne change pas seulement les couleurs. Chaque thème est lié à une personnalité de rendu Markdown, qui gère la structure, la taille, l'interligne, l'espacement et le poids des titres, du corps, des citations, des listes, du code et des légendes d'image.

PresetThème liéTon de mise en page
zhijian-warm-paperzhijianSupport de cours de marque : titres avec barre verticale terre cuite, titres de niveau 3 bleu encre, citation Human Accent, bloc de code noir chaud
kami-documentkamiDocument sensation papier : formel, sobre, titre avec barre verticale bleu encre à gauche
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-duneFamille magazine électronique : via magazine_variant, présente respectivement cinq mises en page : classic / research / fieldnote / archive / gallery
elegant-essayelegantLong article rétro : titre centré, interligne aéré, citation style extrait
modern-technicalmodernTutoriel moderne : hiérarchie sans-serif, cartes d'astuce, blocs de code techniques
minimal-notesminimalNotes minimalistes : peu de décorations, grands blancs, citation avec ligne fine

Règles strictes de compatibilité WeChat : Tous les presets produisent du style en ligne ; les couleurs de fond sont en hexadécimal solide ; la section externe, la section contenu et le span de texte déclarent background-color plusieurs fois.

Description des paramètres du thème

ParamètreDescriptionValeur par défaut
--themeNom du thèmezhijian
--font-sizeTaille du corps (px)17
--line-heightInterligne1.58
--accent-colorCouleur d'accentuation (titres, liens)#B85235
--background-colorCouleur de fond, doit être en hexadécimal solide#F5F4ED
--max-widthLargeur maximale du contenu (px)640
--outputChemin du fichier de sortieGénéré automatiquement

Règles de sortie

Chemin de sortie par défaut :

  • Entrée : chemin/vers/article.md
  • Sortie : chemin/vers/article_wechat.html

Contenu de la sortie :

  1. Fichier HTML complet
  2. Styles en ligne (directement copiables dans l'éditeur WeChat)
  3. Liens vers les images conservés
  4. Gestion automatique des blocs de code, citations, listes, etc.

Flux de travail

  1. Lire le fichier Markdown

    • Analyser le frontmatter (titre, résumé, etc.)
    • Extraire le contenu du corps
  2. Charger la configuration du thème

    • Lire les paramètres du thème
    • Appliquer les paramètres personnalisés de l'utilisateur
  3. Convertir en HTML

    • Markdown → structure HTML
    • Appliquer les styles du thème (en ligne)
    • Traiter les éléments spéciaux (code, images, citations)
  4. Fichier de sortie

    • Générer le HTML complet
    • Sauvegarder dans le chemin spécifié
    • Afficher les instructions d'utilisation

Aperçu des thèmes

Vous ne savez pas quel thème choisir ? Utilisez le générateur d'aperçu des thèmes pour comparer tous les thèmes :

# Générer une page d'aperçu pour tous les thèmes (avec un article d'exemple par défaut)
node scripts/generate-preview.mjs

# Générer un aperçu avec votre propre article
node scripts/generate-preview.mjs chemin/vers/votre-article.md

# Prévisualiser seulement un thème spécifique (séparé par une virgule, sans espace)
node scripts/generate-preview.mjs article.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# Chemin de sortie personnalisé
node scripts/generate-preview.mjs article.md --themes kami,elegant --output /chemin/vers/mon-apercu.html

La page d'aperçu affichera les thèmes sélectionnés côte à côte, ce qui facilite la comparaison rapide. Le fichier preview.html généré peut être ouvert dans un navigateur.

Ajouter un nouveau thème

Étapes :

  1. Créez un nouveau fichier de configuration de thème dans le répertoire themes/ :

    # themes/mon-theme.yaml
    name: mon-theme
    description: Mon thème personnalisé
    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. Utilisez le nouveau thème :

    /wechat-styler article.md --theme mon-theme
    

Règles strictes de compatibilité WeChat (validation déterministe)

Les règles suivantes sont exécutées de manière déterministe par scripts/validate.mjs, sans dépendre de la bonne volonté du modèle. Les résultats de la conversion sont automatiquement validés ; exécutez node scripts/validate.mjs output.html indépendamment pour une revérification (0 ERROR = code de sortie 0, avec ERROR = code de sortie 1, pour CI/automatisation).

La conversion utilise une stratégie soft gate : si une ERREUR est détectée, le fichier est tout de même généré (l'utilisateur peut voir le rendu), mais un rapport détaillé en rouge est affiché à la fin ; seul le script de validation indépendant renvoie un code de sortie non nul.

Niveau ERREUR (le produit final doit en être exempt, sinon des problèmes surviendront après collage)

  1. Balises interdites : <style> / <script> / <link> / <iframe> / <meta> (dans le body) / <input>
    • Raison : L'éditeur WeChat les supprime, ce qui rend les styles/scripts/ressources externes inopérants
  2. Attributs interdits : class= / id= / contenteditable
    • Raison : L'éditeur WeChat les supprime, les styles doivent être entièrement en ligne via style
  3. CSS interdits : position:fixed|absolute / display:grid|flex / @media / @keyframes
    • Raison : Après collage, décalage, effondrement de la mise en page ou ignorés
  4. Fonctions interdites : rgba() / hsla()
    • Raison : Les couleurs de fond sont perdues dans l'éditeur, elles doivent être en hexadécimal solide (ex. #1B365D, pas rgba(27,54,93,0.8))
  5. Polices externes interdites : Références externes url(...) dans @font-face
    • Raison : Échec de chargement, police de remplacement, mise en page déformée ; utiliser des piles de polices système

Niveau AVERTISSEMENT (recommandé à corriger, ne bloque pas)

  1. Image sans alt : <img> sans attribut alt (accessibilité + fallback si le serveur d'images est indisponible)
  2. Risque de décalage d'image : <img> sans margin:0 auto ou display:block (peut se décaler à gauche après collage)
  3. Élément bloc sans style : <p> / <h2> / <blockquote> sans attribut style (style perdu après collage)

Stratégies de compatibilité intégrées dans convert.mjs (aucune manipulation manuelle nécessaire)

  • Toutes les couleurs de fond en hexadécimal solide, pas de rgba()
  • Section externe / section contenu / span de texte : trois niveaux de déclaration de background-color, réduisant le risque de perte de fond après collage
  • Parent de l'image text-align:center + propre margin:0 auto;display:block double filet de sécurité, empêchant le décalage
  • Tous les styles en ligne, pas de balise <style> ni de CSS externe

Mécanisme de placeholders

Vous écrivez mais le serveur d'images n'est pas encore prêt, et vous voulez voir l'effet de mise en page ? Écrivez des placeholders dans votre Markdown, la conversion les rendra sous forme de boîte grise centrée en pointillés :

Ceci est un paragraphe normal.

【Insérer:capture d'écran vidéo du début de l'article】

Suite du paragraphe normal.

Rendu : Boîte sobre en pointillés gris neutre + texte gris centré « 📷 Élément à ajouter : xxx », sans voler la vedette au texte. Lorsque l'image est prête, remplacez 【Insérer:xxx】 par ![alt](url).

Seuls les 【Insérer:xxx】 occupant une ligne entière (crochets pleine largeur) sont pris en charge ; en ligne, ils ne sont pas déclenchés, pour éviter de toucher au corps du texte.

Exemple

Entrée Markdown :

---
title: Titre de l'article
summary: Résumé de l'article
---

## Titre de section

Ceci est un paragraphe normal, contenant du **gras** et du `code`.

![Légende de l'image](https://example.com/image.png)

> Ceci est une citation

Sortie HTML :

  • Fichier HTML complet, utilisable sur WeChat
  • Tous les styles en ligne
  • Copier-coller direct

Implémentation technique

Scripts principaux : scripts/convert.mjs (conversion) + scripts/validate.mjs (validation de compatibilité WeChat)

Dépendances :

  • Node.js 18+
  • marked (analyse Markdown)
  • js-yaml (analyse YAML)

Structure du répertoire :

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → HTML WeChat (appelle validate soft gate)
│   ├── validate.mjs         # Validation de compatibilité WeChat (exécutable indépendamment / appelé par convert)
│   └── generate-preview.mjs # Générateur de page d'aperçu des thèmes
├── 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

Dernière mise à jour : 2026-07-07 Version : 1.4.0 Auteur : Dapeng

Skills associés