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.

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.yamlin 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.
| Theme | Befehl | Variante | Schriftart / Typografie-Charakter |
|---|---|---|---|
| Ink Classic | --theme magazine-ink | ink-classic | Serifenloser Fließtext + serifenbetonte Überschriften, feine Linien, Dash-Liste, Pull-Quote, generisches Magazin-Layout |
| Indigo | --theme magazine-indigo | indigo-research | Inter/SF Pro Fließtext + Source Serif Überschriften, linke Forschungsleiste, Note-Quote, technische Codeblöcke |
| Forest | --theme magazine-forest | forest-fieldnote | Kalligrafie-/Songti-Fließtext + non-fiktive Überschriften, zentrierte Titel, Field-Note-Zitate, natürliche Bildunterschriften |
| Kraft | --theme magazine-kraft | kraft-archive | Songti-Fließtext + Archive-Titelbox, Archiv-Zitate, römisch nummerierte Listen, altpapierartige Code-Blöcke |
| Dune | --theme magazine-dune | dune-gallery | Avenir-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-editorialrenderer, aber durchmagazine_variantwerden 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 autofü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.
| Preset | Gebundenes Theme | Layout-Charakter |
|---|---|---|
zhijian-warm-paper | zhijian | Brand-Handout: warme Terrakotta-Linie in Überschriften, tintenblaue dritte Ebene, Human Accent Zitate, warm-schwarze Codeblöcke |
kami-document | kami | Papierdokument: förmlich, zurückhaltend, Überschriften mit linker tintenblauer Linie |
magazine-editorial | magazine-ink/magazine-indigo/magazine-forest/magazine-kraft/magazine-dune | E-Magazin-Familie: durch magazine_variant werden classic/research/fieldnote/archive/gallery Layouts dargestellt |
elegant-essay | elegant | Retro-Langtext: zentrierte Überschriften, großzügige Zeilenabstände, exzerptartige Zitate |
modern-technical | modern | Modernes Tutorial: serifenlose Hierarchie, Hinweiskarten, technische Codeblöcke |
minimal-notes | minimal | Minimalistische 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
| Parameter | Beschreibung | Standard |
|---|---|---|
--theme | Themenname | zhijian |
--font-size | Schriftgröße (px) | 17 |
--line-height | Zeilenhöhe | 1.58 |
--accent-color | Akzentfarbe (Überschriften, Links) | #B85235 |
--background-color | Hintergrundfarbe, muss solid hex sein | #F5F4ED |
--max-width | Maximale Inhaltsbreite (px) | 640 |
--output | Ausgabedateipfad | automatisch generiert |
Ausgaberegeln
Standard-Ausgabepfad:
- Eingabe:
pfad/zu/artikel.md - Ausgabe:
pfad/zu/artikel_wechat.html
Ausgabeinhalt:
- Vollständige HTML-Datei
- Inline-Styles (direkt in den WeChat-Editor einfügbar)
- Bildlinks bleiben erhalten
- Codeblöcke, Zitate, Listen etc. werden automatisch verarbeitet
Arbeitsablauf
-
Markdown-Datei einlesen
- Frontmatter parsen (Titel, Zusammenfassung etc.)
- Textinhalt extrahieren
-
Theme-Konfiguration laden
- Theme-Parameter einlesen
- Benutzerdefinierte Parameter anwenden
-
In HTML umwandeln
- Markdown → HTML-Struktur
- Theme-Styles anwenden (inline)
- Spezielle Elemente verarbeiten (Code, Bilder, Zitate)
-
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:
-
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' -
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)
- Verbotene Tags:
<style>/<script>/<link>/<iframe>/<meta>im body /<input>- Grund: Der WeChat-Editor entfernt sie, wodurch Styles/Skripte/externe Ressourcen unwirksam werden
- Verbotene Attribute:
class=/id=/contenteditable- Grund: Der WeChat-Editor entfernt sie, Styles müssen alle inline in
stylesein
- Grund: Der WeChat-Editor entfernt sie, Styles müssen alle inline in
- 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
- Verbotene Funktionen:
rgba()/hsla()- Grund: Hintergrundfarben gehen im Editor verloren; es müssen solide Hex-Werte verwendet werden (z.B.
#1B365D, nichtrgba(27,54,93,0.8))
- Grund: Hintergrundfarben gehen im Editor verloren; es müssen solide Hex-Werte verwendet werden (z.B.
- Verbotene externe Schriftarten:
@font-facemiturl(...)- Grund: Fallback schlägt fehl, Layout wird verzerrt; verwende System-Schriftstapel
WARN-Level (empfohlen, blockiert nicht)
- Bilder ohne alt:
<img>fehltalt-Attribut (Barrierefreiheit + Fallback, wenn der Bildserver ausfällt) - Bildverschiebungsrisiko:
<img>fehltmargin:0 autooderdisplay:block(kann nach dem Einfügen nach links rutschen) - Blockelemente ohne style:
<p>/<h2>/<blockquote>fehltstyle-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-colorauf äußerer Sektion / Inhaltssektion / Textspan, um Hintergrundverlust nach dem Einfügen zu vermeiden - Bild-Elternelement
text-align:center+ Bild selbstmargin: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 .
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`.

> 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
