Communitygithub.com

zjp1997720/wechat-styler

Markdown を、微信公衆号向けのインラインスタイル付き HTML に変換します。10種類のテーマ、確定的な検証、プレースホルダー対応。

wechat-styler とは?

このスキルは、Markdown 形式の記事を微信公衆号 (WeChat Official Account) に貼り付け可能な、インラインスタイル付きの HTML に変換するツールです。開発者やコンテンツクリエイターが、複雑な CSS を意識することなく、美しいレイアウトの記事を生成できるよう設計されています。10種類のテーマが用意されており、ブランドに合わせた配色やフォント、余白などを簡単に適用できます。特に、微信公衆号エディタに貼り付けた際にスタイルが失われないよう、背景色は solid hex で指定し、スタイルはすべてインラインで記述するなど、厳格な互換性ルールに基づいて HTML を生成します。また、画像の準備ができていない部分にはプレースホルダーを挿入できる機能や、生成された HTML が公衆号の仕様に適合しているかを自動検証するスクリプトも備えており、実用的な運用を強力にサポートします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

WeChat Styler 左右並列効果プレビュー
alt
画像キャプション

ドキュメント

WeChat Styler - 公衆号排版ツール

Markdown 記事をエレガントな公衆号 HTML 形式に変換します。複数のテーマを切り替え可能です。

効果プレビュー

2026-06-30 に取得した実際の WorkBuddy ドキュメントの抜粋を使用して生成。左側が元の Markdown、右側が zhijian テーマの出力です。

WeChat Styler 左右並列効果プレビュー

使用方法

# 基本的な使い方(デフォルトテーマ使用)
/wechat-styler path/to/article.md

# テーマを指定
/wechat-styler path/to/article.md --theme kami
/wechat-styler path/to/article.md --theme magazine-ink

# 一括変換(glob パターン対応)
/wechat-styler "articles/*.md" --theme kami
/wechat-styler "01_項目/コンテンツ作成/**/*.md" --theme magazine-ink

# カスタムパラメータ
/wechat-styler path/to/article.md --theme kami --font-size 17 --accent-color "#1B365D"

# 出力先を指定(単一ファイル)
/wechat-styler path/to/article.md --output path/to/output.html

利用可能なテーマ

0. zhijian(智見AI ブランドテーマ)- デフォルトテーマ

オープンソースのお知らせ: これはブランドテーマのサンプルであり、ブランドシステム(色 + フォント + タイポグラフィの個性)をスキルに組み込む方法を示しています。作成者自身のブランドデザインシステムに基づいています。そのまま使用することも、themes/zhijian.yaml の構造を参考にしてご自身のブランドテーマ(色、フォント、top_label の変更)に作り替えることもできます。

特徴:

  • DESIGN.md のブランドシステムに基づく、温かみのある紙質感 × コンサルタントの信頼感
  • 紙のような背景色 #F5F4ED、深みのある暖かいテラコッタのアクションカラー #B85235、インクブルーの構造色 #1B365D
  • 3層のフォント戦略:見出しは楷書体(ブランド感)、本文は宋体(可読性)、UI はゴシック体(機能性)
  • H2 は左側に暖かいテラコッタ色の縦線、H3 はインクブルー、引用ブロックは Human Accent の左線
  • コードブロックは暖かみのある黒背景、12px の角丸、インラインコードはインクブルーで薄い青背景
  • 太字とリンクは #A04A2E(WCAG AA 準拠の安全な暖色)
  • 区切り線は中央揃えの暖かいテラコッタ色の短い線

適用シーン: 智見AI のすべてのブランドコンテンツ — 公衆号記事、研修資料、講座コンテンツ、方法論の共有、AI 導入事例

パラメータ:

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'
accnet_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(紙感編集組版)

特徴:

  • 温かみのある羊皮紙風の背景色:#f5f4ed
  • インクブルーの単一アクセントカラー:#1B365D
  • 中国語の見出しはセリフ体/楷書体スタック、本文は安定したサンセリフスタック
  • 温かみのあるグレースケール、冷たいグレーや真っ白なベースは使用しない
  • 見出し左側の青い縦線、solid tag 背景、控えめな引用ブロック
  • すべての背景色は solid hex を使用し、外枠、コンテンツ、テキストの各レイヤーで繰り返し宣言し、公衆号に貼り付けた後の背景消失リスクを低減

適用シーン: 公衆号の深い考察記事、ビジネス分析、講座コンテンツ、正式な説明文

パラメータ:

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 シリーズ(電子雑誌 × 電子インク)

magazine-web-ppt から移行した5つのプリセット。ink / paper / tint の雑誌的な配色関係を維持しつつ、微信公衆号で安全な HTML に改造:rgba() は使用せず、すべての背景色は solid hex。

テーマコマンドバリアントフォント / 組版の個性
インククラシック--theme magazine-inkink-classicサンセリフ本文 + セリフ見出し、細い罫線、ダッシュリスト、プルクォート、汎用雑誌中面
インディゴブルー--theme magazine-indigoindigo-researchInter/SF Pro 本文 + Source Serif 見出し、左側研究欄、note クォート、技術コードブロック
フォレストインク--theme magazine-forestforest-fieldnote楷書体/宋体本文 + ノンフィクション見出し、中央揃え見出し、フィールドノート引用、自然画像キャプション
クラフトペーパー--theme magazine-kraftkraft-archive宋体本文 + archive 見出しボックス、アーカイブ風引用、ローマ数字順序付きリスト、古紙風コードボックス
デューン--theme magazine-dunedune-galleryAvenir 本文 + Didot/Bodoni 見出し、右揃えギャラリー見出し、ギャラリークォート、ミニマルな画像キャプション

共通の特徴:

  • 各テーマは独立したフォントスタック、フォントサイズ、行間、段落間隔、見出し構造、リストマーカー、引用ブロック、コードブロック、画像キャプションを持ちます。
  • 区切りは余白、短い淡い線、局所的な表示要素が中心。各セクション間に自動で全幅の実線が挿入されることはありません。
  • 5つのテーマは共通の magazine-editorial レンダラーエントリを共有しますが、magazine_variant によって異なる構造分岐に進みます。単なる色の置き換えではありません。
  • すべての背景色は solid hex を使用し、ブロックおよびテキスト span 上で background-color を繰り返し宣言し、公衆号エディタにコピーした後の背景消失確率を低減します。
  • 画像自体に margin:0 auto の中央揃えの保険をかけ、公衆号エディタにコピー後に画像幅が書き換えられて左寄せになるのを防ぎます。
  • 組版は雑誌感を維持しつつも、出力は完全にインライン形式のため、そのまま公衆号エディタにコピーできます。

3. elegant(エレガント・レトロ)

特徴:

  • 中文:方正書宋(FZShuSong-Z01)
  • 英文:Garamond
  • 全体的に淡いグレーの背景
  • 赤系のアクセントカラーシステム
  • セリフ見出し + 等幅コード

適用シーン: ビジネスケース、深い分析、知識共有

パラメータ:

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(モダン・シンプル)

特徴:

  • サンセリフフォント
  • 真っ白な背景
  • 青のアクセントカラー
  • クリアでモダン

適用シーン: テクノロジー製品、チュートリアル、ニュース速報

パラメータ:

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(ミニマリスト)

特徴:

  • ミニマルな白黒
  • 豊富な余白
  • グレーのトーン
  • 控えめでエレガント

適用シーン: 哲学的考察、個人的なエッセイ、アートレビュー

パラメータ:

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

テーマは色を変えるだけではありません。各テーマは Markdown レンダリングの個性(パーソナリティ)を持ち、見出し、本文、引用、リスト、コード、画像キャプションの構造、フォントサイズ、行間、間隔、フォントウェイトを決定します。

Presetバインドされるテーマ組版のトーン
zhijian-warm-paperzhijianブランド講義:暖かいテラコッタの縦線見出し、インクブルーの3次見出し、Human Accent 引用、暖かみのある黒のコードブロック
kami-documentkami紙感ドキュメント:フォーマル、控えめ、見出し左側のインクブルーの縦線
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune電子雑誌ファミリー:magazine_variant により、classic / research / fieldnote / archive / gallery の5つの組版を個別に表現
elegant-essayelegantレトロ長文:中央揃え見出し、ゆったりとした行間、抜粋風引用
modern-technicalmodernモダンチュートリアル:サンセリフの階層構造、ヒントカード、テクニカルコードブロック
minimal-notesminimalミニマルノート:装飾を抑え、大きな余白、細い線の引用

公衆号互換のハードルール: すべての preset 出力は inline style。背景色は solid hex を使用。外枠 section、コンテンツ section、テキスト span で background-color を繰り返し宣言。

テーマパラメータ説明

パラメータ説明デフォルト値
--themeテーマ名zhijian
--font-size本文フォントサイズ(px)17
--line-height行の高さ1.58
--accent-colorアクセントカラー(見出し、リンク)#B85235
--background-color背景色。solid hex を使用すること#F5F4ED
--max-widthコンテンツの最大幅(px)640
--output出力ファイルパス自動生成

出力ルール

デフォルトの出力パス:

  • 入力:path/to/article.md
  • 出力:path/to/article_wechat.html

出力内容:

  1. 完全な HTML ファイル
  2. インラインスタイル(公衆号にそのままコピー可能)
  3. 画像リンクを保持
  4. コードブロック、引用ブロック、リストなどを自動処理

ワークフロー

  1. Markdown ファイルの読み込み

    • frontmatter(タイトル、概要など)の解析
    • 本文コンテンツの抽出
  2. テーマ設定の読み込み

    • テーマパラメータの読み取り
    • ユーザーカスタムパラメータの適用
  3. HTML への変換

    • Markdown → HTML 構造
    • テーマスタイルの適用(インライン)
    • 特殊要素の処理(コード、画像、引用)
  4. ファイルの出力

    • 完全な HTML の生成
    • 指定パスへの保存
    • 使用方法の出力

テーマプレビュー

どのテーマを選ぶか迷っていますか?テーマプレビュー生成ツールを使って、すべてのテーマの効果を比較できます:

# すべてのテーマのプレビューページを生成(デフォルトのサンプル記事を使用)
node scripts/generate-preview.mjs

# カスタム記事でプレビューを生成
node scripts/generate-preview.mjs path/to/your-article.md

# 指定したテーマのみプレビュー(カンマ区切り、スペースなし)
node scripts/generate-preview.mjs article.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# カスタム出力パス
node scripts/generate-preview.mjs article.md --themes kami,elegant --output /path/to/my-preview.html

プレビューページでは、選択したテーマの効果を並べて表示するため、素早く比較・選択できます。生成された preview.html はブラウザで開いて確認できます。

新しいテーマの拡張

手順:

  1. themes/ ディレクトリに新しいテーマ設定ファイルを作成:

    # themes/my-theme.yaml
    name: my-theme
    description: 私のカスタムテーマ
    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. 新しいテーマを使用:

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

公衆号互換のハードルール

以下のルールは scripts/validate.mjs によって確定的に実行され、モデルの自己判断に依存しません。変換時の生成物は自動検証されます。独立して node scripts/validate.mjs output.html を実行することで再チェック可能です(ERROR 0 で終了コード 0、ERROR ありで終了コード 1。CI/自動化向け)。

変換時はソフトゲート戦略を採用:ERROR が見つかってもファイルは通常通り生成され(ユーザーは結果を先に確認できる)、最後に赤色のレポート詳細が出力されます。独立した validate スクリプトのみがゼロ以外の終了コードを返します。

ERROR レベル(生成物は 0 である必要あり。そうでなければ貼り付け後に問題が発生)

  1. 禁止タグ:<style> / <script> / <link> / <iframe> / body 内の <meta> / <input>
    • 理由:公衆号エディターが取り除き、スタイル/スクリプト/外部リソースが機能しなくなる
  2. 禁止属性:class= / id= / contenteditable
    • 理由:公衆号エディターが取り除く。スタイルはすべて style にインライン化する必要がある
  3. 禁止 CSS:position:fixed|absolute / display:grid|flex / @media / @keyframes
    • 理由:貼り付け後に位置がずれる、レイアウトが崩れる、または無視される
  4. 禁止関数:rgba() / hsla()
    • 理由:背景色がエディターで失われる。solid hex(例:#1B365D。rgba(27,54,93,0.8) は不可)を使用すること
  5. 禁止外部フォント:@font-face の url(...) 外部参照
    • 理由:読み込み失敗でフォールバックし、レイアウトが崩れる。システムフォントスタックを使用すること

WARN レベル(修正推奨、ブロックはしない)

  1. 画像に alt なし:<img> に alt 属性がない(アクセシビリティ + 画像ホスト障害時の保険)
  2. 画像位置ずれリスク:<img> に margin:0 auto または display:block がない(貼り付け後に左寄せになる可能性あり)
  3. ブロック要素に style なし:<p> / <h2> / <blockquote> に style 属性がない(貼り付け後にスタイルが失われる)

convert.mjs に組み込み済みの互換戦略(手動処理は不要)

  • すべての背景色は solid hex を使用し、rgba() は使用しない
  • 外枠 section / コンテンツ section / テキスト span の3層で background-color を繰り返し宣言し、貼り付け後の背景消失を低減
  • 画像の親要素に text-align:center + 画像自身に margin:0 auto;display:block の二重保険で位置ずれ防止
  • すべてのスタイルはインライン化し、<style> タグや外部 CSS は使用しない

プレースホルダー機構

執筆時に画像ホストがまだ準備できていないが、レイアウト効果を先に確認したい場合。Markdown 内にプレースホルダーを記述すると、変換時に中央揃えのグレーの点線ボックスとしてレンダリングされます:

これは本文です。

【挿入:記事冒頭の動画スクリーンショット】

本文の続き。

レンダリング効果:控えめなニュートラルグレーの点線ボックス + 中央揃えのグレーテキスト「📷 素材待ち:xxx」、本文の視覚的重みを奪いません。画像の準備ができたら、【挿入:xxx】 を ![alt](url) に置き換えてください。

一行を独占する 【挿入:xxx】(全角角括弧)のみ対応。インラインではトリガーされず、本文の誤検出を防ぎます。

例

入力 Markdown:

---
title: 記事タイトル
summary: 記事概要
---

## 章の見出し

これは**太字**と`コード`を含む本文です。

![画像キャプション](https://example.com/image.png)

> これは引用です

出力 HTML:

  • 公衆号で使用可能な完全な HTML
  • すべてのスタイルはインライン
  • コピー&ペーストでそのまま使用可能

技術実装

コアスクリプト: scripts/convert.mjs(変換)+ scripts/validate.mjs(公衆号互換性検証)

依存関係:

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

ディレクトリ構造:

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → 公衆号 HTML(ソフトゲートで validate を呼び出し)
│   ├── validate.mjs         # 公衆号互換性検証(独立実行可 / convert から参照)
│   └── generate-preview.mjs # テーマプレビューページ生成ツール
├── 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

最終更新: 2026-07-07 バージョン: 1.4.0 作者: 大鵬

関連スキル