Markdownで改行するには:スペース2つ、バックスラッシュ、brタグ。

MarkdownのファイルでEnterを押しても、2行が1行につながって表示されます。これは仕様です。その理由と、改行を強制する3つの方法を説明します。

macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。

要点

Markdownでは1つの改行はスペースとして扱われるため、行はつながって表示されます。行を折り返すには、行末にスペース2つかバックスラッシュを置くか、HTMLの<br>タグを置きます。新しい段落を始めるには、空行を入れます。

First line\
Second line, after a backslash

Next paragraph, after a blank line

·

Markdownが改行を無視する理由

Markdownは段落内の行をつなげます。次のように書くと、

Roses are red
Violets are blue

読み手には1つの段落、Roses are red Violets are blueとして表示されます。ソース中の改行は「ソフト改行」で、テキストを折り返した位置にすぎず、読み手に改行を見せる位置ではありません。このおかげで、ページの見た目を変えずにエディタで長い行を折り返せます。

空行は別です。段落が終わって新しい段落が始まり、間に余白が入ります。たいていの場合、欲しい区切りはこれです。

改行を強制する3つの方法

強制改行(ハード改行)は、同じ段落の中で次の行を始めます。

  1. 行末のスペース2つ

    Enterを押す前に、スペースを2つ以上入力します。どこでも動きますが、スペースは見えず、エディタやGitの設定によっては削除されてしまうことがあります。

  2. 行末のバックスラッシュ

    最後の文字として\を置き、その後ろにスペースを入れません。目に見え、末尾の空白の削除にも耐えます。CommonMarkとGitHub Flavored Markdownの仕様ですが、古いアプリの一部は対応していません。

  3. HTMLのbrタグ

    行末に<br>(または<br/>)を置きます。インラインHTMLを受け付けるほぼすべてのアプリで動きます。表のセル内で改行できる唯一の方法でもあります。

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

3つとも結果は同じです。

Two spaces after this line
comes out on a new line.

どれを使うべきか

  • 新しい段落(空行):別の話題なら、これを使います。いちばん移植性の高い選択です。
  • バックスラッシュ:住所や詩のように、段落の途中で改行したく、アプリがCommonMarkに従っているとき。
  • brタグ:表のセルの中や、ほかの2つに対応しているか分からないとき。
  • スペース2つ:何にも削除されないと確信できるときだけ。

改行はコードスパンの中では効かず、段落のいちばん最後の改行も何も起こしません。空白がほしいときは、<br>を並べるのではなく、空行か見出しを使ってください。

例:住所、詩、リスト項目

強制改行は、郵便の宛先のように、行そのものに意味があるテキストに向いています。

Jane Smith221B Baker StreetLondon

Jane Smith
221B Baker Street
London

リスト項目の中では、行末に改行を置き、次の行を項目の本文の位置に合わせてインデントします。

- Pack the bags  and lock the door
- Leave at eight

長い文章のすべての行で改行が必要なら、そのテキストはおそらくリストかコードブロックです。Markdownにはどちらの構文もあります。

それでも改行できないとき

  • 行末のスペースが1つだけ。2つ以上必要です。
  • バックスラッシュのあとにスペースがある。バックスラッシュは行の最後の文字でなければなりません。
  • エディタが保存時に行末の空白を削除している。バックスラッシュかbrタグに切り替えてください。
  • 同じテキストが場所によって違って見える。GitHubのIssueやコメント欄のように、1つの改行をそのまま改行として扱うアプリがある一方、GitHub上のMarkdownファイルはそうなりません。強制改行ならどちらでも同じ見た目になります。
  • リスト項目や引用の中のテキスト。改行は行末に置き、次の行を項目に合わせてインデントします。

いちばん手早い確認方法は、ファイルをリーダーで開くことです。DotMDはこれらのルールに従います。1つの改行は行をつなげ、スペース2つ、バックスラッシュ、<br>で改行します。閲覧は無料で、DotMD Editorではライブプレビューが入力に合わせて結果を表示します。

Markdownの改行に関するよくある質問

Markdownで改行するには?

段落の中で改行するには、行末にスペース2つ、バックスラッシュ、または<br>タグを置きます。新しい段落を始めるには、空行を入れます。

Markdownで改行が無視されるのはなぜ?

Markdownは1つの改行をスペースとして扱うため、行が1つの段落につながります。目に見える改行にするには、空行、行末のスペース2つ、バックスラッシュ、または<br>を使います。

スペース2つはいつでも改行として働きますか?

CommonMarkとGitHub Flavored Markdownでは、はい。ただし、エディタやGitのツールは行末のスペースを削除することが多く、その場合は気づかないうちに改行が消えます。バックスラッシュか<br>のほうが安全です。

Markdownの表の中で改行するには?

セル内で<br>を使います。表の1行は1行のテキストなので、スペース2つやバックスラッシュは使えません。

その他の質問