Communitygithub.com

zjp1997720/wechat-styler

Wandle Markdown in paste-bereites HTML mit Inline-Styles für WeChat Official Accounts um. 10 Themes, deterministische Validierung, Platzhalter-Unterstützung.

Was ist wechat-styler?

WeChat Styler ist ein Tool, das Markdown-Dokumente in elegant formatierte, direkt in den WeChat-Editor einfügbare HTML-Seiten konvertiert. Es bietet 10 vorgefertigte Themes mit jeweils eigenem Layout-Charakter – von einem warmen Papierthema bis hin zu modernen, minimalistischen oder Magazin-inspirierten Stilen. Der Skill ist für Claude Code (und ähnliche Agenten) optimiert und wird über Konsolenbefehle wie `/wechat-styler artikel.md --theme kami` gesteuert. Die Validierung prüft automatisch die Kompatibilität mit dem WeChat-Editor, indem sie verbotene Tags (wie `<style>`, `<script>`), externe CSS und `rgba()`-Farben ausschließt. Alle Hintergrundfarben werden als solide Hex-Werte gesetzt und mehrfach wiederholt, um Datenverlust beim Einfügen zu vermeiden. Feature: Platzhalter wie `【插入:Bildbeschreibung】` ermöglichen es, die Formatierung zu testen, bevor Grafiken fertig sind. Die Themen sind komplett anpassbar und unterstützen benutzerdefinierte Schriftarten, Farben und Parameter über YAML-Dateien.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

WeChat Styler Vorschau
alt
Bildunterschrift

Dokumentation

WeChat Styler – 公众号排版工具

Wandle Markdown-Artikel in elegantes, direkt in den WeChat-Editor einfügbares HTML um. Unterstützt mehrere Themes.

Vorschau

Erstellt mit einem echten WorkBuddy-Dokument vom 30.06.2026: Links das originale Markdown, rechts die Ausgabe mit dem zhijian-Theme.

WeChat Styler Vorschau

Verwendung

# Einfache Verwendung mit Standardtheme
/wechat-styler pfad/zu/artikel.md

# Theme auswählen
/wechat-styler pfad/zu/artikel.md --theme kami
/wechat-styler pfad/zu/artikel.md --theme magazine-ink

# Batch-Umwandlung (Glob-Muster)
/wechat-styler "artikel/*.md" --theme kami
/wechat-styler "01_Projekt/Inhalte/**/*.md" --theme magazine-ink

# Benutzerdefinierte Parameter
/wechat-styler pfad/zu/artikel.md --theme kami --font-size 17 --accent-color "#1B365D"

# Ausgabe in bestimmte Datei (Einzeldatei)
/wechat-styler pfad/zu/artikel.md --output pfad/zu/ausgabe.html

Verfügbare Themes

0. zhijian (ZhiJian AI Brand Theme) – Standardtheme

Open-Source-Hinweis: Dies ist ein Beispiel-Branding-Theme, das zeigt, wie man ein komplettes Brandsystem (Farben + Schriftarten + Typografie-Persönlichkeit) in einen Skill integriert. Es stammt aus dem eigenen Brandsystem des Autors. Du kannst es direkt verwenden oder seine Struktur als Vorlage nehmen, um themes/zhijian.yaml in dein eigenes Branding-Theme zu verwandeln (Farben, Schriftarten, top_label austauschen).

Eigenschaften:

  • Basierend auf dem DESIGN.md-Brandsystem: warmes Papiergefühl × Beraterglaubwürdigkeit
  • Hintergrund #F5F4ED (Papieroptik), Akzentfarbe #B85235 (warmes Terrakotta), Strukturfarbe #1B365D (tintenblau)
  • Dreistufige Schriftstrategie: Überschriften in Kalligrafie (Markengefühl), Fließtext in Serifen (Lesbarkeit), UI in serifenlos (Funktionalität)
  • H2 mit linker warmer Terrakotta-Linie, H3 in Tintenblau, Blockzitate mit Human Accent linker Linie
  • Codeblöcke mit warm-schwarzem Hintergrund und 12px abgerundeten Ecken, Inline-Code in Tintenblau mit hellem Hintergrund
  • Fettgedruckter Text und Links in #A04A2E (WCAG AA sichere warme Farbe)
  • Trennlinie als kurze, zentrierte warme Terrakotta-Linie

Anwendungsszenarien: Alle ZhiJian AI-Inhalte – WeChat-Artikel, Schulungsunterlagen, Kursinhalte, Methodenbeiträge, KI-Implementierungsbeispiele

Parameter:

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 (Papiergefühl-Redaktionslayout)

Eigenschaften:

  • Warmer Pergament-Hintergrund: #f5f4ed
  • Einfarbige Betonung in Tintenblau: #1B365D
  • Chinesische Überschriften mit Serifen-/Kalligrafie-Schriftstapel, Fließtext mit stabilem serifenlosen Stapel
  • Warme Graustufen, keine kalten Grautöne oder reines Weiß
  • Überschriften mit blauer linker Linie, soliden Tag-Hintergründen, zurückhaltenden Zitaten
  • Alle Hintergrundfarben als solide Hex-Werte, dreifach deklariert (äußere Sektion, Inhaltssektion, Textspan), um Verlust beim Einfügen zu vermeiden

Anwendungsszenarien: Tiefgehende WeChat-Artikel, Business-Analysen, Kursinhalte, formelle Texte

Parameter:

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. magazine-Serie (E-Magazin × E-Ink)

Aus magazine-web-ppt migrierte 5 Presets, die die Magazin-Farbbeziehungen von ink / paper / tint beibehalten und gleichzeitig in sicheres WeChat-HTML umgewandelt wurden: Kein rgba(), alle Hintergrundfarben als solide Hex-Werte.

ThemeBefehlVarianteSchriftart / Typografie-Charakter
Ink Classic--theme magazine-inkink-classicSerifenloser Fließtext + serifenbetonte Überschriften, feine Linien, Dash-Liste, Pull-Quote, generisches Magazin-Layout
Indigo--theme magazine-indigoindigo-researchInter/SF Pro Fließtext + Source Serif Überschriften, linke Forschungsleiste, Note-Quote, technische Codeblöcke
Forest--theme magazine-forestforest-fieldnoteKalligrafie-/Songti-Fließtext + non-fiktive Überschriften, zentrierte Titel, Field-Note-Zitate, natürliche Bildunterschriften
Kraft--theme magazine-kraftkraft-archiveSongti-Fließtext + Archive-Titelbox, Archiv-Zitate, römisch nummerierte Listen, altpapierartige Code-Blöcke
Dune--theme magazine-dunedune-galleryAvenir-Fließtext + Didot/Bodoni-Überschriften, rechtsbündige Galerietitel, Gallery-Zitat, minimalistische Bildunterschriften

Gemeinsame Eigenschaften:

  • Jedes Theme hat einen eigenen Schriftstapel, Schriftgröße, Zeilenabstand, Absatzabstand, Überschriftenstruktur, Listenmarker, Zitatblock, Codeblock und Bildunterschrift.
  • Trennung durch Weißraum, kurze Linien und lokale Markierungen; keine automatische durchgehende Linie zwischen Abschnitten.
  • Alle fünf Themes teilen den Einstiegspunkt magazine-editorial renderer, aber durch magazine_variant werden unterschiedliche Layout-Zweige durchlaufen – nicht nur Farben ersetzt.
  • Alle Hintergrundfarben sind solide Hex-Werte und werden auf Abschnitts- und Textspan-Ebene wiederholt, um Hintergrundverlust im WeChat-Editor zu minimieren.
  • Bilder haben ein margin:0 auto für horizontale Zentrierung, um zu verhindern, dass der WeChat-Editor die Bildbreite ändert und sie nach links verschiebt.
  • Das Layout bewahrt den Magazin-Charakter, aber die Ausgabe ist vollständig inline und kann direkt in den WeChat-Editor eingefügt werden.

3. elegant (Elegant Retro)

Eigenschaften:

  • Chinesisch: FZShuSong-Z01 (FangZheng ShuSong)
  • Englisch: Garamond
  • Leichter grauer Hintergrund
  • Rotes Akzentfarbsystem
  • Serifen-Überschriften + Monospace-Code

Anwendungsszenarien: Geschäftsfälle, Tiefenanalysen, Wissensaustausch

Parameter:

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 (Modern Minimal)

Eigenschaften:

  • Serifenlose Schriftarten
  • Reiner weißer Hintergrund
  • Blauer Akzent
  • Klar und modern

Anwendungsszenarien: Technologieprodukte, Tutorials, Kurznachrichten

Parameter:

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

Eigenschaften:

  • Minimalistisches Schwarz-Weiß
  • Viel Weißraum
  • Grautöne
  • Zurückhaltend elegant

Anwendungsszenarien: Philosophische Gedanken, persönliche Essays, Kunstkritiken

Parameter:

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

Renderer-Presets

Ein Theme tauscht nicht nur Farben aus. Jedes Theme ist an eine Markdown-Render-Persönlichkeit gebunden, die für Überschriften, Fließtext, Zitate, Listen, Code und Bildunterschriften die Struktur, Schriftgröße, Zeilenhöhe, Abstände und Schriftstärke festlegt.

PresetGebundenes ThemeLayout-Charakter
zhijian-warm-paperzhijianBrand-Handout: warme Terrakotta-Linie in Überschriften, tintenblaue dritte Ebene, Human Accent Zitate, warm-schwarze Codeblöcke
kami-documentkamiPapierdokument: förmlich, zurückhaltend, Überschriften mit linker tintenblauer Linie
magazine-editorialmagazine-ink/magazine-indigo/magazine-forest/magazine-kraft/magazine-duneE-Magazin-Familie: durch magazine_variant werden classic/research/fieldnote/archive/gallery Layouts dargestellt
elegant-essayelegantRetro-Langtext: zentrierte Überschriften, großzügige Zeilenabstände, exzerptartige Zitate
modern-technicalmodernModernes Tutorial: serifenlose Hierarchie, Hinweiskarten, technische Codeblöcke
minimal-notesminimalMinimalistische Notizen: wenig Dekoration, viel Weißraum, dünne Linien für Zitate

WeChat-Kompatibilitäts-Hardregeln: Alle Presets geben Inline-Style aus; Hintergrundfarben als solide Hex-Werte; äußere Sektion, Inhaltssektion und Textspan deklarieren wiederholt background-color.

Theme-Parameter

ParameterBeschreibungStandard
--themeThemennamezhijian
--font-sizeSchriftgröße (px)17
--line-heightZeilenhöhe1.58
--accent-colorAkzentfarbe (Überschriften, Links)#B85235
--background-colorHintergrundfarbe, muss solid hex sein#F5F4ED
--max-widthMaximale Inhaltsbreite (px)640
--outputAusgabedateipfadautomatisch generiert

Ausgaberegeln

Standard-Ausgabepfad:

  • Eingabe: pfad/zu/artikel.md
  • Ausgabe: pfad/zu/artikel_wechat.html

Ausgabeinhalt:

  1. Vollständige HTML-Datei
  2. Inline-Styles (direkt in den WeChat-Editor einfügbar)
  3. Bildlinks bleiben erhalten
  4. Codeblöcke, Zitate, Listen etc. werden automatisch verarbeitet

Arbeitsablauf

  1. Markdown-Datei einlesen

    • Frontmatter parsen (Titel, Zusammenfassung etc.)
    • Textinhalt extrahieren
  2. Theme-Konfiguration laden

    • Theme-Parameter einlesen
    • Benutzerdefinierte Parameter anwenden
  3. In HTML umwandeln

    • Markdown → HTML-Struktur
    • Theme-Styles anwenden (inline)
    • Spezielle Elemente verarbeiten (Code, Bilder, Zitate)
  4. Datei ausgeben

    • Vollständiges HTML erzeugen
    • Am angegebenen Pfad speichern
    • Nutzungshinweise ausgeben

Theme-Vorschau

Du weißt nicht, welches Theme du wählen sollst? Verwende den Theme-Vorschau-Generator, um alle Themes zu vergleichen:

# Vorschau-Seite für alle Themes generieren (mit Standard-Beispielartikel)
node scripts/generate-preview.mjs

# Mit eigenem Artikel generieren
node scripts/generate-preview.mjs pfad/zu/deinem-artikel.md

# Nur bestimmte Themes vorschauen (kommagetrennt, ohne Leerzeichen)
node scripts/generate-preview.mjs artikel.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# Eigenen Ausgabepfad festlegen
node scripts/generate-preview.mjs artikel.md --themes kami,elegant --output /pfad/zu/meiner-vorschau.html

Die Vorschau-Seite zeigt die ausgewählten Themes nebeneinander an, um einen schnellen Vergleich zu ermöglichen. Die generierte preview.html kann im Browser geöffnet werden.

Neues Theme erstellen

Schritte:

  1. Neue Theme-Konfigurationsdatei im Verzeichnis themes/ anlegen:

    # themes/mein-theme.yaml
    name: mein-theme
    description: Mein benutzerdefiniertes Theme
    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. Neues Theme verwenden:

    /wechat-styler artikel.md --theme mein-theme
    

WeChat-Kompatibilitäts-Hardregeln

Die folgenden Regeln werden von scripts/validate.mjs deterministisch durchgesetzt, ohne auf das Verständnis des Modells angewiesen zu sein. Das convert-Ergebnis wird automatisch validiert; eigenständiger Aufruf node scripts/validate.mjs ausgabe.html zur Nachprüfung (0 bei 0 ERROR, Exit 1 bei ERROR – für CI/Automatisierung).

Convert verwendet eine weiche Tür-Strategie: Bei einem ERROR wird die Datei trotzdem erstellt (der Nutzer kann das Ergebnis sehen), am Ende wird ein roter Bericht ausgegeben. Nur das eigenständige validate-Skript gibt einen Exit-Code ungleich Null zurück.

ERROR-Level (müssen 0 sein, sonst treten nach dem Einfügen Probleme auf)

  1. Verbotene Tags: <style> / <script> / <link> / <iframe> / <meta> im body / <input>
    • Grund: Der WeChat-Editor entfernt sie, wodurch Styles/Skripte/externe Ressourcen unwirksam werden
  2. Verbotene Attribute: class= / id= / contenteditable
    • Grund: Der WeChat-Editor entfernt sie, Styles müssen alle inline in style sein
  3. Verbotenes CSS: position:fixed|absolute / display:grid|flex / @media / @keyframes
    • Grund: Nach dem Einfügen verschieben sich Elemente, das Layout bricht zusammen oder wird ignoriert
  4. Verbotene Funktionen: rgba() / hsla()
    • Grund: Hintergrundfarben gehen im Editor verloren; es müssen solide Hex-Werte verwendet werden (z.B. #1B365D, nicht rgba(27,54,93,0.8))
  5. Verbotene externe Schriftarten: @font-face mit url(...)
    • Grund: Fallback schlägt fehl, Layout wird verzerrt; verwende System-Schriftstapel

WARN-Level (empfohlen, blockiert nicht)

  1. Bilder ohne alt: <img> fehlt alt-Attribut (Barrierefreiheit + Fallback, wenn der Bildserver ausfällt)
  2. Bildverschiebungsrisiko: <img> fehlt margin:0 auto oder display:block (kann nach dem Einfügen nach links rutschen)
  3. Blockelemente ohne style: <p> / <h2> / <blockquote> fehlt style-Attribut (Styles gehen nach dem Einfügen verloren)

Von convert.mjs bereits eingebaute Kompatibilitätsstrategien (keine manuelle Bearbeitung nötig)

  • Alle Hintergrundfarben als solide Hex-Werte, kein rgba()
  • Dreifache Deklaration von background-color auf äußerer Sektion / Inhaltssektion / Textspan, um Hintergrundverlust nach dem Einfügen zu vermeiden
  • Bild-Elternelement text-align:center + Bild selbst margin:0 auto;display:block – doppelter Fallback gegen Verschiebung
  • Alle Styles inline, keine <style>-Tags oder externes CSS

Platzhalter-Mechanismus

Wenn Bilder noch nicht fertig sind, du aber schon das Layout sehen möchtest: Schreibe Platzhalter in Markdown, convert rendert sie als zentrierte, gestrichelte graue Box:

Dies ist ein Textabsatz.

【Einfügen:Startbildschirm-Videoaufnahme】

Weiterer Text.

Rendering-Effekt: dezente neutrale graue gestrichelte Box + zentrierter grauer Text „📷 Bildmaterial fehlt: xxx“, lenkt nicht vom Text ab. Wenn das Bild bereit ist, ersetze 【Einfügen:xxx】 durch ![alt](url).

Unterstützt nur 【Einfügen:xxx】 in einer eigenen Zeile (vollständige eckige Klammern); inline wird es nicht ausgelöst, um den Text nicht versehentlich zu beeinträchtigen.

Beispiel

Eingabe Markdown:

---
title: Artikeltitel
summary: Artikelzusammenfassung
---

## Kapitelüberschrift

Dies ist ein Textabsatz mit **Fett** und `Code`.

![Bildunterschrift](https://example.com/image.png)

> Dies ist ein Zitat

Ausgabe HTML:

  • Vollständiges, für WeChat nutzbares HTML
  • Alle Styles inline
  • Direkt kopier- und einfügbar

Technische Umsetzung

Kernskripte: scripts/convert.mjs (Konvertierung) + scripts/validate.mjs (WeChat-Kompatibilitätsprüfung)

Abhängigkeiten:

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

Verzeichnisstruktur:

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → WeChat HTML (weiche Tür, ruft validate auf)
│   ├── validate.mjs         # WeChat-Kompatibilitätsprüfung (eigenständig / von convert referenziert)
│   └── generate-preview.mjs # Theme-Vorschau-Generator
├── 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

Letztes Update: 2026-07-07 Version: 1.4.0 Autor: Dapeng

Verwandte Skills