Markdownの見出し
行頭に # と空白を書くと見出しになります。# 1つが文書のタイトル、## が章で、6段階まであります。レベル、下線形式、ID、よくある間違いを説明します。
要点
Markdownで見出しを書くには?
行頭に # を1〜6個と空白を書きます。# タイトル がもっとも大きく、###### 注記 がもっとも小さい見出しで、HTMLの <h1> から <h6> になります。文書のタイトルに # を1つ使い、章には ## を使います。
Markdown
# 文書のタイトル
## 章
### 節表示結果
文書のタイトル
章
節
見出しの書き方と例
# の数でレベルが決まります。いくつかの細かい点で、その行が見出しになるかどうかが決まります。
6つのレベル
# を1つ増やすごとに1段下がります。たいていの文書は3段階までで足ります。
Markdown
# 見出し1
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6表示結果
見出し1
見出し2
見出し3
見出し4
見出し5
見出し6
# のあとに空白
空白がないと、その行は普通の段落のままです。
Markdown
#空白がないと見出しになりません
# 空白があれば見出しです表示結果
#空白がないと見出しになりません
空白があれば見出しです
下線形式の見出し
文字の下の行に = か - を並べると、レベル1かレベル2の見出しになります。この形式はこの2段階だけです。
Markdown
文書のタイトル
==============
章のタイトル
------------表示結果
文書のタイトル
章のタイトル
末尾の #
文字のあとの # は書いても書かなくてもよく、見出しには表示されません。
Markdown
## インストール ##表示結果
インストール
見出しの中の書式
見出しには太字、インラインコード、リンクを含められます。
Markdown
### `--force` オプション
### [バージョン2](https://example.com/v2)の**互換性のない**変更表示結果
--force オプションバージョン2の互換性のない変更
見出しに独自のIDを付ける
Pandoc、Hugo、kramdownでは、見出しのあとに波括弧でIDを書けます。# のリンクでそのIDを指定できます。
Markdown
## インストール {#install}
[インストールへ](#install)Pandoc、Hugo、kramdownだけの書き方です。ほかのMarkdownアプリでは表示が異なるため、プレビューはありません。
各サービスでの対応状況
# の見出しはほぼどこでも使えます。チャットツールでは使えるレベルが少ないか、使えません。
| サービス | 対応 | 補足 |
|---|---|---|
| GitHub / GitLab | 対応 | 6段階すべてに対応し、すべての見出しに # リンク用のIDが付きます。 |
| Discord | 違いあり | メッセージで #、##、### が使え、-# は小さな灰色の文字になります。 |
| Slack | 非対応 | メッセージに見出しはなく、太字で代用します。 |
| Obsidian | 対応 | 6段階に対応し、見出しを折りたため、[[ノート#見出し]] でリンクできます。 |
| Notion | 違いあり | #、##、### と空白を入力すると見出しのブロックになります。 |
| Qiita / Zenn | 対応 | 6段階に対応し、記事の目次が自動で作られます。 |
よくある質問
Markdownの見出しは何段階ありますか?
6段階です。
# のレベル1から ###### のレベル6まであり、HTMLでは <h1> から <h6> になります。見出しにならないのはなぜですか?
# のあとに空白を入れ(#タイトル ではなく # タイトル)、行頭に書きます。前に空白が4つ以上あると、その行はコードになります。見出しにリンクするには?
# と見出しのIDを書きます:[インストール](#インストール)。GitHubでは見出しの文字を小文字にし、空白をハイフンに変えたものがIDになり、日本語はそのまま残ります。目次を作るには?
見出しへのリンクを手で並べるか、Markdown 目次ジェネレーターで見出しから自動で作ります。
レベル1の見出しは1つだけにするべきですか?
一般的には、文書のタイトルに
# を1つだけ使い、章は ## から始めます。ページのタイトルを見出しとして表示するサイトも多く、そうしたサイト向けの文書は ## から書き始めます。見出しに独自のIDを付けられますか?
CommonMarkとGitHubではできません。Pandoc、Hugo、kramdownでは
## タイトル {#my-id} と書けます。# の見出しと下線形式の見出しの違いは?
# の見出しと下線形式の見出しの違いは?レベル1と2では同じ結果になります。下線形式はレベル2までしかなく、
# のほうが一般的で、ソースでも見つけやすい書き方です。Discordで見出しを書くには?
行頭に
#、##、### のいずれかと空白を書きます。-# と空白を書くと小さな灰色の文字になります。