Markdown の見出しの書き方は？ # の数と、見出しへのリンク
Markdown の見出しは、行の頭に # を 1〜6 個書き、空白を 1 つあけてから文字を書きます。# が 1 個なら一番大きな見出し（レベル 1）、6 個なら一番小さな見出し（レベル 6）です。
# と文字の間の空白を忘れると、見出しにならず、# のついたふつうの文になります（標準の仕様 CommonMark の決まり）。# を 7 個以上書いたときも見出しになりません。
見出しのレベルは、どう書き分ける？
# 見出し 1（大見出し） ## 見出し 2 ### 見出し 3 #### 見出し 4 ##### 見出し 5 ###### 見出し 6
文書の題を #、その中の章を ##、さらに細かい節を ### にする、というように、レベルを飛ばさずに順に使うと、読む人にも、目次をつくるアプリにも構造が伝わります。
見出しにならないのはなぜ？
| 書き方 | 見出しになる？ | 理由 |
|---|---|---|
## はじめに | なる | # のあとに空白がある |
##はじめに | ならない | # のあとに空白がない |
####### 見出し | ならない | # が 7 個以上 |
␣␣␣␣## 見出し（空白 4 つ） | ならない | 行の頭の空白が 4 つ以上だと、コードブロックになる |
## はじめに見出しになる？なる理由#のあとに空白がある##はじめに見出しになる？ならない理由#のあとに空白がない####### 見出し見出しになる？ならない理由#が 7 個以上␣␣␣␣## 見出し（空白 4 つ）見出しになる？ならない理由行の頭の空白が 4 つ以上だと、コードブロックになる
# のあとの空白は、半角の空白かタブにします。日本語の入力のまま打った全角の空白（ ）では、見出しになりません。
# を使わない見出しの書き方はある？
文の次の行に === を書くとレベル 1、--- を書くとレベル 2 の見出しになります（CommonMark では setext 見出しと呼ぶ）。
大見出し === 中見出し ---
--- は区切り線の書き方でもあるので、区切り線を引きたいときは、前の行を空行にします。文のすぐ下に --- を書くと、区切り線ではなく見出しになります。
見出しへのリンク（ページ内リンク）は、どう書く？
見出しへのリンクは [文字](#見出しの名前) と書きます。# のあとに書く名前（アンカー）のつくり方は仕様にはなく、アプリやサイトごとに違います。
GitHub は、見出しの文字を小文字にし、空白をハイフン（-）に変え、ほかの記号を消して名前をつくります。たとえば ## Getting Started へのリンクは [はじめに](#getting-started) です。同じ見出しが 2 つあると、2 つ目には -1 がつきます。
よくある質問
- 見出しに番号を自動でつけることはできる？
- Markdown の書き方には、見出しに番号を自動でつけるものはありません。番号が要るときは、見出しの文字に「1.」などと書き込むか、番号づけに対応したアプリの機能を使います。
- 見出しの中で改行できる？
- # で書く見出しは、その 1 行で終わるので、見出しの中で改行はできません。長い見出しは、短くするか、見出しの下の文に分けます。