Markdownの改行と段落
Markdownは隣り合った行を1つの段落につなげます。行末にバックスラッシュを書くとそこで改行し、空行を入れると新しい段落になります。
要点
Markdownで改行するには？
行末にバックスラッシュ \ を書いて、次の行に続けます。行末に空白を2つ入れても同じで、HTMLが使える環境では <br> も使えます。改行が1回だけだと空白として扱われ、空行を入れると新しい段落になります。
Markdown
古池や\
蛙飛び込む\
水の音
空行を入れると新しい段落です。表示結果
古池や
蛙飛び込む
水の音
空行を入れると新しい段落です。
改行の書き方と例
段落の中で改行する方法が3つと、新しい段落を始める方法があります。
1回の改行はつながる
隣り合った行は1つの段落になり、改行の位置は空白になります。日本語の文中でも、ブラウザによってはこの空白が表示されます。
Markdown
古池や
蛙飛び込む
水の音表示結果
古池や 蛙飛び込む 水の音
行末のバックスラッシュ
行末の直前にバックスラッシュを書くと改行されます。ソース上で見えるため、エディタに消されません。
Markdown
古池や\
蛙飛び込む\
水の音表示結果
古池や
蛙飛び込む
水の音
行末の空白2つ
行末に空白を2つ以上入れても改行されます。ここでは各行の末尾にありますが、目に見えず、保存時に削除するエディタも多くあります。
Markdown
古池や
蛙飛び込む
水の音表示結果
古池や
蛙飛び込む
水の音
<br> タグ
HTMLが使える環境では、<br> で好きな位置を改行できます。表のセルの中でも使えます。
Markdown
1行目<br>2行目
| 住所 |
| --- |
| 東京都千代田区<br>丸の内1-1 |表示結果
1行目
2行目
| 住所 |
|---|
| 東京都千代田区 丸の内1-1 |
新しい段落
空行を入れると新しい段落になり、改行より広い間隔が空きます。
Markdown
1つ目の段落。
2つ目の段落。表示結果
1つ目の段落。
2つ目の段落。
段落の間に余白を足す
空行をいくつ続けても1つとして扱われます。余白を増やすには、 か <br> だけの行を入れます。
Markdown
このあとに空行が3つあります。
間隔は1つ分だけです。
` ` だけの行が上に余白を作っています。表示結果
このあとに空行が3つあります。
間隔は1つ分だけです。
だけの行が上に余白を作っています。
各サービスでの改行の扱い
入力したとおりに改行するアプリと、Markdownのルールどおりに行をつなげるアプリがあります。
| サービス | 対応 | 補足 |
|---|---|---|
| GitHub | 違いあり | Issue、PR、コメントではすべての改行が残ります。Markdownファイルではバックスラッシュ、空白2つ、<br> が必要です。 |
| Obsidian | 対応 | 設定の「厳密な改行」をオンにしない限り、改行はそのまま表示されます。 |
| Discord / Slack | 対応 | 改行はそのまま表示されます。Shift+Enterで送信せずに改行できます。 |
| Qiita / Zenn | 対応 | どちらも改行1回でそのまま改行されます。 |
| VS Codeのプレビュー | 違いあり | markdown.preview.breaks の設定をオンにしない限り、1回の改行はつながります。 |
よくある質問
Markdownで改行が無視されるのはなぜですか？
段落の中の1回だけの改行は空白として扱われ、ソースで長い行を折り返せるようになっています。行末にバックスラッシュか空白2つを入れると改行が残ります。
どの改行方法がおすすめですか？
行末のバックスラッシュです。CommonMarkとGitHub Flavored Markdownの記法で、ソース上でも見えます。行末の空白2つは消えやすく、
<br> はHTMLが使える環境でしか使えません。表のセルの中で改行するには？
セルの中に
<br> を書きます。実際に改行すると表の行が終わってしまいます。段落の間の余白を広げるには？
空行を増やしても無視されます。段落の間に
か <br> だけの行を入れます。GitHubのコメントでは改行できるのに、READMEではできないのはなぜですか？
GitHubはIssue、プルリクエスト、コメントではすべての改行を残し、Markdownファイルでは標準のルールに従います。ファイルではバックスラッシュか空白2つで改行します。
リスト項目の中で改行するには？
行末にバックスラッシュか空白2つを入れ、次の行を項目の文字の位置まで字下げします。
\n と書くと改行されますか？
\n と書くと改行されますか？されません。バックスラッシュと
n はその2文字のまま表示されます。Enterキーで改行し、上の方法を使います。