菜单
Zenn向けMarkdown（Zenn Flavored Markdown）の記法を適用し、記事・スクラップ・本の原稿を執筆・校正する。見出し階層、コードブロック、数式、メッセージ／アコーディオン、リンクカード、GitHub/YouTube/X埋め込み、mermaid制限などを扱う。Zenn記事、技術ブログ原稿、zenn-cliプロジェクトのMarkdown編集時に使う。GitHub Flavored Markdownのみ、CommonMark一般論、Zenn以外のCMS（Qiita/Note/dev.to）には使わない。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
日本語の文章で文と文のつながりを点検し、直前の文の不足、常識的な連続性、読者視点から論理のほころびを防ぐ。エッセイ、記事、レポート、解説文の執筆・推敲・レビューで使う。法的判断、数学的証明、事実確認のみ、文法校正のみ、意図的なシュール表現や断片的表現の矯正には使わない。
日本語の文章を、誇張、借り物の美辞麗句、過剰な謙遜を避け、実感に近い等身大な表現へ整える。エッセイ、プロフィール、商品説明、自己紹介、note、スピーチ、振り返り文の推敲で使う。法的文書、逐語訳、意図的に言葉を高める詩、学術的な出典確認、事実検証には使わない。
macOSのスクリーンショットを、screencaptureと補助CLIで取得する。画面全体、ウィンドウ指定、選択範囲、タイマー撮影、クリップボード保存に対応する。macOS上でエージェントが再現可能なパスへスクリーンショットを保存したい場合に使う。OCR、画像編集、動画収録、macOS以外のスクリーンショット取得には使わない。
文章、記事、レポート、企画書の論理破綻をレビューし、論点、必要情報、推論、結論と根拠の構造を確認する。Why So、So What、MECEの観点で飛躍、矛盾、論点ずれ、根拠不足を検出する。公開前や改稿前に文章の筋道を点検するときに使う。単なる校正、文体調整、事実確認のみ、法的助言、数学的証明の厳密検証には使わない。
UI 変更や状態遷移を伴う PR に、E2E テスト計画・操作後スクリーンショット・検証結果・検証データの副作用を確認エビデンスとして残す。 gh image で画像をアップロードし、Chrome DevTools MCP で画面を操作・撮影し、gh でテスト計画と結果を PR コメントへ投稿する際に使用。 「PR にスクショを貼る」「UI エビデンスを残す」「E2E 確認結果を PR にまとめる」「レビュー用に画面の証跡を添付」と依頼された時に適用。 内部ロジックのみの変更や、既存の自動テストで担保できる変更には使わない。コミット作成や PR 本体の作成フローには使わない。
WXTを使ったブラウザ拡張開発を支援する。プロジェクト調査、entrypoint設計、manifestと権限変更、content script UI、storage、messaging、build、zip、ブラウザ検証を扱う。WXTプロジェクトの作成、変更、監査、デバッグ時に使う。非WXT拡張、汎用フロントエンド、拡張ストア審査には使わない。
| name | zenn-markdown |
| description | Zenn向けMarkdown（Zenn Flavored Markdown）の記法を適用し、記事・スクラップ・本の原稿を執筆・校正する。見出し階層、コードブロック、数式、メッセージ／アコーディオン、リンクカード、GitHub/YouTube/X埋め込み、mermaid制限などを扱う。Zenn記事、技術ブログ原稿、zenn-cliプロジェクトのMarkdown編集時に使う。GitHub Flavored Markdownのみ、CommonMark一般論、Zenn以外のCMS（Qiita/Note/dev.to）には使わない。 |
Zenn の Markdown 方言（公式記法一覧）に沿って原稿を書く・直す。詳細な記法表は必要なときだけ references/ を読む。
.md を新規執筆または校正するときzenn-cli プロジェクト内の Markdown をプレビュー前に整えるとき<br> 以外の HTML 埋め込み非対応）##（見出し2）から始めることを原則とする（アクセシビリティ推奨）。# は記事タイトル相当の文脈でのみ使う。breaks 相当）。空行で段落区切りにする。references/syntax-core.md に従う。=250x で幅指定、直下の *キャプション* でキャプションを付ける。```js:fooBar.js、diff は ```diff js:fooBar.js、ハイライトなし＋ファイル名は ```:text または ```text。$$ の 前後に空行、インラインは $...$。references/zenn-extensions.md を読み、次から選ぶ:
:::message / :::message alert（警告）:::details タイトル（アコーディオン）: を増やす（::::details など）<!-- ... --> のみ（複数行コメントは非対応）。references/embeds.md の表から記法を選ぶ。_ を含む URL でリンクが途切れる場合:
@[card](URL)@[tweet](URL)<URL>#L1-L3 形式。```mermaid ブロックを使う。& チェーン 10 以下、クリックイベントは無効（設定しない）。references/mermaid-limits.md を読む。scripts/validate-zenn-markdown.py を対象ファイルに実行する:python3 scripts/validate-zenn-markdown.py path/to/article.md
zenn-cli 利用時はローカルプレビューでレンダリングを確認する:npx zenn preview
| 目的 | 記法 |
|---|---|
| 注意ボックス | :::message / :::message alert |
| 折りたたみ | :::details タイトル … ::: |
| リンクカード | URL 単独行 または @[card](URL) |
| GitHub コード | permalink 単独行 + 任意 #L10-L20 |
| 数式ブロック | 空行 + $$ … $$ + 空行 |
| 表内改行 | <br> |
| 症状 | 対処 |
|---|---|
| 数式がレンダリングされない | $$ の前後に空行があるか確認 |
| URL カードが途中で切れる | _ を含む URL → @[card](...) または <...> |
| mermaid がエラー表示 | 2000 文字超・& 過多・非対応記法を references/mermaid-limits.md で確認 |
コードにファイル名を付けたいが : を含む | 現状不可（区切りが : のため）。ファイル名から : を除くか本文で明示 |
| インラインコード先頭/末尾の半角スペースが消える | Zenn 仕様。必要なら U+2000 等の特殊スペースを検討 |
<br> 以外の HTML が効かない | Markdown／Zenn 拡張記法に置き換える |
| CLI と Web で差分 | npm install zenn-cli@latest で CLI を更新 |
| ファイル | 内容 |
|---|---|
references/syntax-core.md | 見出し・リスト・画像・表・コード・数式・脚注 |
references/zenn-extensions.md | message / details / コメント |
references/embeds.md | リンクカード・SNS・GitHub・スライド・Figma 等 |
references/mermaid-limits.md | mermaid 制限と分割方針 |