このページでは Zenn の markdown 記法を一覧で紹介します。
見出し
# 見出し1
## 見出し2
### 見出し3
#### 見出し4
見出し 1
見出し 2
見出し 3
見出し 4
リスト
- Hello!
- Hola!
- Bonjour!
* Hi!
- Hello!
- Hola!
- Bonjour!
- Hi!
リストのアイテムには*もしくは-を使います。
番号付きリスト
1. First
2. Second
- First
- Second
テキストリンク
[アンカーテキスト](リンクのURL)
アンカーテキスト
Ctrl + Kのショートカットでも挿入できます。
画像
画像の横幅を指定する
画像の表示が大きすぎる場合は、URL の後に半角スペースを空けて=○○xと記述すると、画像の幅を px 単位で指定できます。
キャプションをつける
画像のすぐ下の行に*で挟んだテキストを配置すると、キャプションのような見た目で表示されます。
*キャプション*
captions
画像にリンクを貼る
以下のようにすることで画像に対してリンクを貼ることもできます。
[](リンクのURL)
テーブル
| Head | Head | Head |
| ---- | ---- | ---- |
| Text | Text | Text |
| Text | Text | Text |
| Head | Head | Head |
|---|---|---|
| Text | Text | Text |
| Text | Text | Text |
コードブロック
コードは「```」で挟むことでブロックとして挿入できます。以下のように言語を指定するとコードへ装飾（シンタックスハイライト）が適用されます。
```js
```
const great = () => {
console.log("Awesome");
};
シンタックスハイライトには Prism.js を使用しています。
📄 対応言語の一覧 →
ファイル名を表示する
言語:ファイル名と:区切りで記載することで、ファイル名がコードブロックの上部に表示されるようになります。
```js:ファイル名
```
const great = () => {
console.log("Awesome")
}
diff のシンタックスハイライト
2021/01/25〜、diffと言語のハイライトを同時に適用できるようになりました。以下のようにdiffと言語名を半角スペース区切りで指定します。
```diff js
```
@@ -4,6 +4,5 @@
+ const foo = bar.baz([1, 2, 3]) + 1;
- let foo = bar.baz([1, 2, 3]);
なお、diffの使用時には、先頭に+、-、半角スペースのいずれが入っていない行はハイライトされません。
同時にファイル名を指定することも可能です。
```diff js:ファイル名
```
@@ -4,6 +4,5 @@
+ const foo = bar.baz([1, 2, 3]) + 1;
- let foo = bar.baz([1, 2, 3]);
数式
Zenn ではKaTeXによる数式表示に対応しています。
KaTeX のバージョンは常に最新バージョンを使用します。
数式のブロックを挿入する
$$で記述を挟むことで、数式のブロックが挿入されます。たとえば
$$
e^{i\theta} = \cos\theta + i\sin\theta
$$
は以下のように表示されます。
インラインで数式を挿入する
$a\ne0$というように$ひとつで挟むことで、インラインで数式を含めることができます。たとえば
引用
> 引用文
> 引用文
引用文
引用文
注釈
注釈を指定するとページ下部にその内容が表示されます。
脚注の例[^1]です。インライン^[脚注の内容その2]で書くこともできます。
[^1]: 脚注の内容その1
区切り線
-----
インラインスタイル
*イタリック*
**太字**
~~打ち消し線~~
インラインで`code`を挿入する
イタリック
太字
打ち消し線
インラインでcodeを挿入する
インラインのコメント
自分用のメモをしたいときは HTML のコメント記法を使用できます。
<!-- TODO: ◯◯について追記する -->
この形式で書いたコメントは公開されたページ上では表示されません。ただし、複数行のコメントには対応していないのでご注意ください。
Zenn 独自の記法
メッセージ
:::message
メッセージをここに
:::
:::message alert
警告メッセージをここに
:::
アコーディオン（トグル）
:::details タイトル
表示したい内容
:::
タイトル
表示したい内容
要素をネストさせるには
外側の要素の開始/終了に : を追加します。
::::details タイトル
:::message
ネストされた要素
:::
::::
タイトル
コンテンツの埋め込み
リンクカード
# URLだけの行
https://zenn.dev/zenn/articles/markdown-guide
URL だけが貼り付けられた行があると、その部分がカードとして表示されます。
また@[card](URL)という書き方でカード型のリンクを貼ることもできます。
アンダースコア _ を含む URL が正しく認識されない場合
markdown パーサの仕様により、アンダースコア（_）を含む URL で、正しく URL が認識されないことがあります。
https://zenn.dev/__example__
https://zenn.dev/example
対処法
- カード型のリンクとして表示したい場合は
@[card](ここにURL)という書き方をしてください - 単純にリンク化された URL を貼り付けたい場合は
<https://zenn.dev/__example__>のような形で<と>で URL を囲むようにしてください
ツイート
# ツイートのURLだけの行（前後に改行が必要です）
https://twitter.com/jack/status/20
以前は@[tweet](ツイートのURL)の記法を採用していましたが、2020/12/27〜URL を貼り付けるだけでツイートを埋め込むことが可能になりました。
アンダースコア _ を含む URL が正しく認識されない場合
markdown パーサの仕様により、URL の/の区切りの中に 2 つ以上アンダースコア（_）を含むと、自動リンクが途中で途切れてしまいます。
https://twitter.com/__example__/status/12345678910
https://twitter.com/example/status/12345678910
対処法
このような URL では@[tweet](ツイートのURL)という書き方をしていただくようお願いします。
リプライ元のツイートを非表示にする
リプライを埋め込んだ場合、デフォルトでリプライ元のツイートも含まれて表示されます。ツイートのURL?conversation=noneのようにクエリパラメータにconversation=noneを指定すると、リプライ元のツイートが含まれなくなります。
YouTube
# YouTubeのURLだけの行（前後に改行が必要です）
https://www.youtube.com/watch?v=WRVsOCh907o
以前は@[youtube](YouTubeの動画ID)という記法を採用していましたが、2021/03/03〜URL を貼り付けるだけで動画を埋め込むことが可能になりました。
GitHub
2022/04〜より、GitHub 上のソースコードファイルを埋め込めるようになりました。
GitHub 上のファイルへの URL またはパーマリンクだけの行を作成すると、その部分に GitHub の埋め込みが表示されます。
# GitHubのファイルURLまたはパーマリンクだけの行（前後に改行が必要です）
https://github.com/octocat/Hello-World/blob/master/README
上記のリンクは、以下のように表示されます。
行の指定
GitHub と同じように、リンクの末尾に#L00-L00のような形で表示するファイルの開始行と終了行を指定することができます。
# コードの開始行と終了行を指定
https://github.com/octocat/Spoon-Knife/blob/main/README.md#L1-L3
上記のリンクは以下のように表示されます。
また、開始行のみ指定することもできます。
# コードの開始行のみ指定
https://github.com/octocat/Spoon-Knife/blob/main/README.md#L3
上記のリンクは、以下のように開始行のみ埋め込まれて表示されます。
テキストファイル以外は埋め込めません
埋め込めるファイルは、ソースコードなどのテキストファイルのみとなっています。
もし画像などのファイルを指定した場合は、以下のような表示になります。
GitHub Gist
@[gist](GistのページURL)
2020/12/28〜対応しました。特定のファイルだけ埋め込みたい場合は@[gist](https://gist.github.com/foo/bar?file=example.json)のようにクエリ文字列で?file=ファイル名という形で指定します。
CodePen
@[codepen](ページのURL)
デフォルトの表示タブはページのURL?default-tab=html,cssのようにクエリを指定することで変更できます。
SlideShare
@[slideshare](スライドのkey)
SlideShare の埋め込み iframe に含まれる...embed_code/key/○○...の◯◯の部分を入力します。
SpeakerDeck
@[speakerdeck](スライドのID)
SpeakerDeck で取得した埋め込みコードに含まれるdata-idの値を入力します。
JSFiddle
@[jsfiddle](ページのURL)
CodeSandbox
@[codesandbox](embed用のURL)
CodeSandbox では、各ページから埋め込み用の<iframe>を取得できます。この<iframe>に含まれるsrcの URL を括弧の中に入力します。
StackBlitz
@[stackblitz](embed用のURL)
StackBlitz では、各ページから「Embed URL」を取得できます。取得した URL をそのまま括弧の中に入力します。
Figma
@[figma](ファイルまたはプロトタイプのURL)
Figma では、ファイルまたはプロトタイプのページで共有リンクを取得できます。取得した URL をそのまま括弧の中に入力します。
オンラインエディターではモーダルから挿入可能
オンラインのエディターでは「+」ボタンを押すことで、外部コンテンツ埋め込み用のモーダルを表示できます。
その他の埋め込み可能なコンテンツ
オンラインエディターの埋め込みの選択肢としては表示されませんが、以下の埋め込み記法もサポートしています。
blueprintUE
@[blueprintue](ページのURL)
例：
@[blueprintue](https://blueprintue.com/render/0ovgynk-/)
blueprintUE を埋め込むには、公開されているページの URL をそのまま括弧の中に入力します。
ダイアグラム
2021/06/08〜、mermaid.js によるダイアグラム表示に対応しました。コードブロックの言語名をmermaidとすることで自動的にレンダリングされます。
```mermaid
graph TB
A[Hard edge] -->|Link text| B(Round edge)
B --> C{Decision}
C -->|One| D[Result one]
C -->|Two| E[Result two]
```
は以下のように表示されます。
他にもシーケンス図やクラス図が表示できます。文法は mermaid.js に従っていますので、どのように書けばよいかは公式サイトの文法を参照してください。
制限事項
Zenn で mermaid.js 対応を行うにあたり、いくつか制限事項を設定させていただいています。制限事項は今後も様子を見て追加・廃止・値の変更など行う可能性があります。
クリックイベントの無効化
Interaction 機能として図の要素にクリックイベントなどが設定できますが、セキュリティの観点で Zenn では無効にさせていただきます。
ブロックあたりの文字数制限 - 2000 文字以内
ブロックあたりの文字数を2000文字に制限させていただいています。これを超えた場合、ダイアグラムが表示される代わりにエラーメッセージが表示されます。
ブロックあたりの Chain 数制限 - 10 以下
フローチャートにおいて、ノードをひとまとまりで表現する記述として&が利用できます。以下のようなイメージです。
```mermaid
graph LR
a --> b & c--> d
```
は以下のように表示されます。
便利ですが、数が多くなるとノードの接続が多くなり、ブラウザ側での描画に負荷が生じる可能性があるため、&の数を10に制限させていただきます。こちらも超えた場合はダイアグラムの代わりにエラーメッセージが表示されます。