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つの方法
強制改行(ハード改行)は、同じ段落の中で次の行を始めます。
-
行末のスペース2つ
Enterを押す前に、スペースを2つ以上入力します。どこでも動きますが、スペースは見えず、エディタやGitの設定によっては削除されてしまうことがあります。
-
行末のバックスラッシュ
最後の文字として
\を置き、その後ろにスペースを入れません。目に見え、末尾の空白の削除にも耐えます。CommonMarkとGitHub Flavored Markdownの仕様ですが、古いアプリの一部は対応していません。 -
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つやバックスラッシュは使えません。