Markdown記法のチートシートです。
本ページではQiitaで使用可能なMarkdownのみ掲載しているため、一部原文と異なります。
Markdownの原文については、Daring Fireball: Markdown Syntax Documentationをご覧下さい。
また、コードに関する記法はGitHub Flavored Markdownに準拠しています。
Qiitaでシンタックスハイライト可能な言語一覧については、 シンタックスハイライト可能な言語 をご覧下さい。
Code - コードの挿入
たとえば、Rubyで記述したコードをファイル名「qiita.rb」として投稿したいときは、 バッククオート を使用して以下のように投稿するとシンタックスハイライトが適用されます。 1
コードブロック上下に空行を挿入しないと正しく表示されないことがあります。
(空行)
```ruby:qiita.rb
puts 'The best way to log and share programmers knowledge.'
```
(空行)
結果
puts 'The best way to log and share programmers knowledge.'
また、コードをインライン表示することも可能です。
` puts 'Qiita'` はプログラマのための技術情報共有サービスです。
結果
puts 'Qiita' はプログラマのための技術情報共有サービスです。
インラインコードがn個連続するバッククオートを含む場合、n+1連続のバッククオートで囲みます。
`` `バッククオート` `` や ``` ``2連続バッククオート`` ``` も記述できます。
結果
`バッククオート` や ``2連続バッククオート`` も記述できます。
インラインコードの中身が CSS の <color> 型の RGB 16進数表記, rgb(), rgba(), hsl(), hsla() 場合横にその色が表示されます。
`#ffce44`
`rgb(255,0,0)`
`rgba(0,255,0,0.4)`
`hsl(100, 10%, 10%)`
`hsla(100, 24%, 40%, 0.5)`
結果
#ffce44
rgb(255,0,0)
rgba(0,255,0,0.4)
hsl(100, 10%, 10%)
hsla(100, 24%, 40%, 0.5)
Gist連携について
GitHubアカウントでQiitaにログインされている場合
投稿時、Octocatアイコンにチェックを入れていただくと連携を行います。
コードを含むアイテムを投稿するとコード部分を抽出し、同じ内容がGistにも投稿される仕組みになっています。
Gistとの連携は、
- コードの投稿
- Qiita側でのコードの編集
の２点について連携しています。
Gist側でコードを編集されても、 Qiitaには反映されません のでご注意下さい。
Format Text - テキストの装飾
Headers - 見出し
- # これはH1タグです
- ## これはH2タグです
- ###### これはH6タグです
Emphasis - 強調・強勢
_ か * で囲むとHTMLのemタグになります。Qiitaでは*イタリック体*になります。
__ か ** で囲むとHTMLのstrongタグになります。Qiitaでは**太字**になります。
_ か * で囲むとHTMLのemタグになります。Qiitaではイタリック体になります。
__ か ** で囲むとHTMLのstrongタグになります。Qiitaでは太字になります。
Strikethrough - 打ち消し線
打ち消し線を使うには ~~ で囲みます。 ~~打ち消し~~
打ち消し線を使うには ~~ で囲みます。 打ち消し
イタリックや太文字と同様に前後に 半角スペース か 改行文字 が必要です。
Details - 折りたたみ
追加情報としたい内容を、detailsタグで囲みます。そして、要約として表示したい文章をsummaryタグで記載します。
Qiitaとは
<details><summary>Qiita(キータ)は、プログラマのための技術情報共有サービスです。</summary>プログラミングに関することをどんどん投稿して、知識を記録、共有しましょう。
Qiitaに投稿すると、自分のコードやノウハウを見やすい形で残すことができます。
技術情報はテキストファイルへのメモではなく、タグを付けた文章、シンタックスハイライトされたコードで保存することで初めて再利用可能な知識になる、そうQiitaでは考えています。</details>
追加情報としたい内容を、detailsタグで囲みます。そして、要約として表示したい文章をsummaryタグで記載します。
Qiitaとは
Qiita(キータ)は、プログラマのための技術情報共有サービスです。
プログラミングに関することをどんどん投稿して、知識を記録、共有しましょう。
Qiitaに投稿すると、自分のコードやノウハウを見やすい形で残すことができます。
技術情報はテキストファイルへのメモではなく、タグを付けた文章、シンタックスハイライトされたコードで保存することで初めて再利用可能な知識になる、そうQiitaでは考えています。
折りたたんだ部分で Markdown を使いたい場合は、折りたたまれる部分全体を <div> で囲ってください。（\` は実際は \ を含みません。また <div> とコードブロックの間には空白行が一つ以上必要です。）
<details><summary>サンプルコード</summary><div>
\```rb
puts 'Hello, World'
\```
</div></details>
サンプルコード
puts 'Hello, World'
Lists - リスト
Disc型
- 文頭に「*」「+」「-」のいずれかを入れるとDisc型リストになります
- 要点をまとめる際に便利です
- リストを挿入する際は、 リストの上下に空行がないと正しく表示されません。また「*」「+」「-」の後にはスペースが必要です
Decimal型
- 文頭に「数字.」を入れるとDecimal型リストになります
- 後からの挿入/移動を考慮して、1. 2. 3. と順番にするのではなく、1. 1. 1. という風に同じ数字にしておくといい具合です。
- リストを挿入する際は、 リストの上下に空行がないと正しく表示されません。また「数字.」の後にはスペースが必要です
Definition型
HTMLの<dl>タグをそのまま使うことで実現できます。
<dl>
<dt>リンゴ</dt>
<dd>赤いフルーツ</dd>
<dt>オレンジ</dt>
<dd>橙色のフルーツ</dd>
</dl>
次のようになります。
- リンゴ
- 赤いフルーツ
- オレンジ
- 橙色フルーツ
注意するべきは、Definition型のリスト内ではMarkdown記法が使えないということです。例えば以下のように書いてはなりません。
<dl>
<dt>リンゴ</dt>
<dd> とても **赤い** フルーツ </dd>
</dl>
次のようになってしまいます。
- リンゴ
- とても **赤い** フルーツ
Definition型リスト内ではMarkdown記法ではなくて、HTMLタグを使って修飾しなければならないので、正しくは次のようになります。
<dl>
<dt>リンゴ</dt>
<dd> とても<strong>赤い</strong>フルーツ </dd>
</dl>
- リンゴ
- とても赤いフルーツ
Markdown記法とHTMLタグの対応は次のようになっています。
| 修飾 | Markdown | HTML |
|---|---|---|
| ボールド | ** ** |
<strong></strong> |
| イタリック | _ _ |
<em></em> |
| コード | `` |
<code></code> |
| リンク | [text](url) |
<a href="url">text</a> |
Checkbox型
Disc型の記述の後ろに[ ]を入れるとチェックボックスが生成されます。
チェックが入った状態のボックスを生成する場合は[x]を入力します。
前後にスペースが必要です。
- [ ] タスク1
- [x] タスク2
- タスク1
- タスク2
Blockquotes - 引用
> 文頭に>を置くことで引用になります。
> 複数行にまたがる場合、改行のたびにこの記号を置く必要があります。
> 引用の上下にはリストと同じく空行がないと正しく表示されません
> 引用の中に別のMarkdownを使用することも可能です。これはネストされた引用です。
Horizontal rules - 水平線
下記は全て水平線として表示されます
* * *
***
*****
- - -
---------------------------------------
Links - リンク
- [リンクテキスト](URL "タイトル")
- タイトル付きのリンクを投稿できます。
例
Markdown: [Qiita](http://qiita.com "Qiita")
結果: Qiita
- [リンクテキスト](URL)
- こちらはタイトル無しのリンクになります。
例
Markdown: [Qiita](http://qiita.com)
結果: Qiita
- [リンクテキスト][名前]
- [名前]:URL
- 同じURLへのリンクを複数箇所に設定することができます
例
Markdown:
[ここ][link-1] と [この][link-1] リンクは同じになります。
[link-1][] も可能です。
[link-1]:http://qiita.com/drafts/c686397e4a0f4f11683d
Images - 画像埋め込み
- 
- タイトル無しの画像を埋め込む
- 
- タイトル有りの画像を埋め込む
例
Markdown: 
結果:
テーブル記法
入力補完を利用する場合
手動で入力する場合
| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This | This | This |
| column | column | column |
| will | will | will |
| be | be | be |
| left | right | center |
| aligned | aligned | aligned |
上記のように書くと，以下のように表示されます．
| Left align | Right align | Center align |
|---|---|---|
| This | This | This |
| column | column | column |
| will | will | will |
| be | be | be |
| left | right | center |
| aligned | aligned | aligned |
数式の挿入
コードブロックの言語指定に "math" を指定することでTeX記法を用いて数式を記述することができます。
```math
\left( \sum_{k=1}^n a_k b_k \right)^{!!2} \leq
\left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```
\left( \sum_{k=1}^n a_k b_k \right)^{\!\!2} \leq
\left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
$2^3$ のように数式を "$" で挟むと行中に数式を埋め込むこともできます。
x^2 + y^2 = 1 をインライン表示すると $x^2 + y^2 = 1$ になります。
ただしインライン数式の中でコントロールシンボル（\{のような、バックスラッシュの後に記号が続くもの）を使うと、後述のバックスラッシュによるMarkdownのエスケープと衝突してしまいます。
$a = \{1, 2, 3\}$
$a = {1, 2, 3}$
なので次のように二つのバックスラッシュを使います。
$a = \\{1, 2, 3\\}$
$a = \{1, 2, 3\}$
目次(TOC)の自動挿入
目次は記事内の見出しを元に自動生成し、右上に自動挿入されます。詳細は目次機能の紹介記事をご覧ください。
注釈
本文中に[^1]や[^example]のように文字列を記述することで、脚注へのリンクを表現できます。注釈内容は、同じく本文中に [^1]: ... というように記述します2。
絵文字
厳密には Markdown 記法の外ですが、: で囲って、絵文字を埋め込めます。
例
\:kissing_closed_eyes: chu☆
chu☆
絵文字チートシート
http://www.emoji-cheat-sheet.com/
その他
バックスラッシュ[\]をMarkdownの前に挿入することで、Markdownをエスケープ(無効化)することができます。
例
# H1
エスケープされています
また本文では一部のHTMLタグも利用可能です。