| name | zenn-markdown |
| description | Zenn記事のmarkdown編集を支援します。Zenn固有の記法（メッセージ、
アコーディオン、コードブロック拡張、埋め込み等）を適切に使用します。
新規記事作成、既存markdownのZenn形式変換に使用します。
|
Zenn Markdown ガイド
Zenn記事を執筆する際のmarkdown記法リファレンスです。
クイックリファレンス
コンテナ記法
:::message
補足情報や注意点（黄色背景）
:::
:::message alert
警告や重要な注意（赤背景）
:::
:::details タイトル
折りたたみコンテンツ
:::
詳細は containers.md を参照。
コードブロック
```js:filename.js
// ファイル名表示付きコード
```
```diff js
- const old = "before";
+ const new = "after";
```
詳細は code-blocks.md を参照。
画像
画像直後に *キャプション* でキャプション表示。
リンクカード
https://example.com
@[card](https://example.com)
URL単独行でカード表示。アンダースコア含むURLは @[card]() を使用。
埋め込み
| サービス | 記法 |
|---|
| YouTube | @[youtube](動画ID) |
| GitHub Gist | @[gist](ユーザー/ID) |
| CodePen | @[codepen](URL) |
| Figma | @[figma](URL) |
| SpeakerDeck | @[speakerdeck](ID) |
詳細は media.md を参照。
数式
$$
e^{i\pi} + 1 = 0
$$
インライン: $a^2 + b^2 = c^2$
mermaid
```mermaid
graph TD
A --> B
```
制限: 2000文字以内、Chain数10以下
詳細は math-diagrams.md を参照。
脚注
テキスト[^1]
[^1]: 脚注の内容
変換チェックリスト
標準markdownからZennへ変換する際の確認項目:
詳細は conversion.md を参照。
注意事項
- HTMLタグは基本的に使用不可（
<br>のみ可）
- 画像altテキストは適切に設定する
- mermaidには文字数・Chain数制限あり
- アンダースコア含むURLはリンクカードで正しく認識されない場合あり
