MDUtil

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で見出しを書くには?

行頭に #、##、### のいずれかと空白を書きます。-# と空白を書くと小さな灰色の文字になります。