Markdown 改行ジェネレーター
改行の書き方を選んでサンプルを編集すると、Markdownがどう表示されるかをその場で確認できます。処理はすべてブラウザ内で完結します。
Markdownで改行するには？
行末に半角スペースを2つ入れてから改行すると、Markdownは同じ段落内で行を折り返し、HTMLでは<br>になります。行末にバックスラッシュを1つ置いても結果は同じです。段落を分けたい場合は、2つの文章の間に空行を1行入れます。
1行目のテキスト。
2行目のテキスト。
これは新しい段落です。最初の2行は<br>で区切られた同じ段落内の2行になり、3行目だけが独立した<p>要素になります。
Markdown 改行ジェネレーターを使う
Markdownの改行方法
行末の半角スペース2つ
行末に半角スペースを2つ入れると、Markdownで改行できます。
プレビュー
この行の末尾には半角スペースが2つあります。
この文は新しい行に表示されます。
Markdownで改行する方法のすべて
Markdownは「改行」（同じ段落内で行を分ける・行間は詰まったまま）と「段落分け」（新しいブロックを作る・上下に余白が入る）を区別します。改行の書き方は4通りあり、それぞれ効かなくなる場面が違います。
行末に半角スペース2つ（標準の改行）
行末にちょうど半角スペースを2つ入れてから改行します。CommonMarkに準拠したレンダラーはすべて、現在の段落の中に<br>を挿入します。スペースは目に見えないため、Markdownの改行が効かない原因のほとんどがこれです。
1行目のテキスト。
2行目のテキスト。同じ段落の中で2行に分かれます。HTMLでは 1行目のテキスト。<br>2行目のテキスト。 となります。
行末のバックスラッシュ
行末にバックスラッシュを1つ置くと、まったく同じ強制改行になります。スペースと違ってソース上で見えるうえ、保存時に行末の空白を削除するエディタでも消えません。CommonMark、GitHub、GitLab、Pandoc、VS Codeのプレビューがいずれも対応しています。
1行目のテキスト。\
2行目のテキスト。出力はスペース2つの場合とまったく同じですが、生のMarkdownを読んだときに改行の位置がひと目で分かります。
空行で段落を分ける
完全な空行を1行入れると、現在の段落が閉じて新しい段落が始まります。これは改行ではなく段落分けで、独立した<p>要素と実際の余白が生まれます。どのMarkdown方言でも例外なく動作します。
これは1つ目の段落です。
これは2つ目の段落です。1つの段落が2行に分かれるのではなく、間にマージンを持つ2つの<p>要素になります。
HTMLの<br>タグ
MarkdownはHTMLをそのまま通すため、フォーマッタに行末スペースを消されたときや、Markdownの記法では手が届かない場所では<br>が最後の手段になります。HTMLをサニタイズするDiscordやSlackでは無視されます。
1行目。<br>2行目。<br />3行目。同じ段落の中に3行が表示されます。<br>と<br />は同じ意味で、自己終了形が意味を持つのは厳密なXHTMLだけです。
表のセルの中で改行する
Markdownの表は1行を物理的に1行で書く必要があるため、セルの中で改行キーを押すと行そのものが終わってしまいます。ここではHTMLタグだけが選択肢で、行末スペースやバックスラッシュは表のパーサーに飲み込まれます。
| 手順 | 説明 |
| --- | --- |
| インストール | npm install を実行<br>その後で開発サーバーを再起動 |2つ目のセルの中で「npm install を実行」と「その後で開発サーバーを再起動」が2行に分かれて表示されます。
リスト項目の中で改行する
リスト項目の中でも行末スペース2つで改行できますが、続きの行は項目本文の位置までインデントする必要があります。インデントがないとレンダラーはリストを閉じ、続きの行を新しい段落として扱います。
- 1つ目の項目、1行目。
1つ目の項目、2行目。
- 2つ目の項目。3つの項目に分かれるのではなく、2行を含む1つ目の項目と、そのあとに続く2つ目の項目になります。
サービスごとのMarkdown改行の違い
もっとも意外なのは、同じサービスでも場所によって挙動が変わる点です。GitHubはコメント欄なら改行キー1回で改行しますが、READMEでは折りたたまれます。公開する場所そのもので必ず確認してください。
| プラットフォーム | 対応状況 | 備考 |
|---|---|---|
| GitHub Issue・コメント | 対応 | 改行キー1回でそのまま改行されます。スペース2つは不要です。 |
| GitHub README・.mdファイル | 一部 | CommonMarkとして描画されるため単独の改行は無視されます。スペース2つ、バックスラッシュ、<br>のいずれかを使います。 |
| GitLab | 対応 | Issue、MR、リポジトリ内のファイルでスペース2つ・バックスラッシュ・<br>がすべて使えます。 |
| Discord | 一部 | Shift+Enterで改行します。行末スペースやHTMLタグは効きません。 |
| Slack | 一部 | Shift+Enterのみです。Slackのmrkdwnには行末スペースや<br>の記法がありません。 |
| Obsidian | 対応 | 既定では単独の改行がそのまま反映されます。「厳密な改行」を有効にするとCommonMarkの挙動になります。 |
| Notion | 一部 | ブロック内はShift+Enterで改行します。貼り付け時に行末スペースは削除されます。 |
| Qiita・Zenn | 対応 | どちらも改行キー1回でそのまま改行されます。段落を分けたいときは空行を入れます。 |
| VS Codeプレビュー | 対応 | 既定はCommonMarkです。markdown.preview.breaksを有効にすると単独の改行も反映されます。 |
このツールでMarkdownの改行を作る手順
改行の方法を選ぶ
タブで行末スペース・バックスラッシュ・段落分け・HTMLの<br>を切り替えます。それぞれのタブが動くサンプルをエディタに読み込みます。
サンプルを編集する
サンプルの文章を書き換えます。改行を作っているのは行末の半角スペース2つ、またはバックスラッシュなので、書き換えるときも残してください。
ライブプレビューで確認する
右側のパネルが入力に合わせて描画するので、公開前に改行が狙った位置に入っているか確認できます。
Markdownをコピーする
コピーボタンを押すと、目に見えない行末スペースも含めた記法がそのままクリップボードに入ります。
よくある質問
markdownで改行できないのはなぜですか？
ほとんどの場合、行末の半角スペース2つが削除されています。多くのエディタやフォーマッタは保存時に行末の空白を取り除きますし、改行キー1回だけの改行はCommonMarkでは普通の半角スペースにまとめられます。自動整形に負けない書き方が必要なら、行末のバックスラッシュかHTMLの<br>タグに切り替えてください。
Markdownの改行に必要なスペースは何個ですか？
行末にちょうど半角スペース2つ、そのあとに改行キーです。3つ以上でも多くのレンダラーでは動きますが、仕様上の最小値である2つがもっとも安全です。何も書かれていない行に置いたスペースは何の効果もありません。
Markdownの改行と段落分けの違いは何ですか？
改行は文章を同じ段落の中に残したまま<br>要素になるため、行と行が詰まって並びます。段落分けは空行1行で作り、段落を閉じて新しい<p>要素を開くので、上下に実際の余白が入ります。住所や詩は改行、内容が変わるところは段落分けが向いています。
改行キーを1回押すだけで改行されますか？
レンダラーによります。素のCommonMarkは単独の改行をソフト改行として扱い、半角スペース1つにまとめます。GitHubのコメント欄、GitLab、Discord、Obsidian、Notion、Qiita、Zennは強制改行が有効なので1回で足ります。GitHub上で描画されるREADMEは対象外です。
markdownの表の中で改行するには？
HTMLの<br>タグを使います。表の1行は物理的に1行で書く必要があるため、本当に改行キーを押すと文章が折り返されるのではなく行が終わってしまいます。行末スペースやバックスラッシュは表のパーサーに飲み込まれ、何も起こりません。
リストの項目の中で改行するには？
行末に半角スペースを2つ入れ、続きの行を項目本文にそろえてインデントします。通常は半角スペース2つか4つです。このインデントがないとレンダラーはリストが終わったと判断し、次の行を新しい段落として扱います。
行末のスペースをエディタで表示するには？
空白文字の表示を有効にします。VS Codeではeditor.renderWhitespaceをallに設定します。Sublime Text、JetBrains系のIDE、VimにもShow Whitespaceやlistといった名前で同じ機能があります。あわせて、Markdownファイルで保存時の行末空白削除が無効になっているかも確認してください。
MarkdownでHTMLの<br>タグは使えますか？
MarkdownをHTMLに変換する環境なら使えます。GitHub、GitLab、Obsidian、Jekyll、Hugo、MkDocsなどが該当します。HTMLをサニタイズするDiscordやSlackでは無視され、タグが消えるかそのまま文字として表示されます。
段落と段落の間にもっと余白を空けるには？
空行を何行続けても1行にまとめられるため、行を増やしても変わりません。段落の間に だけを書いた行を挟むか、<br>タグを2つ続けて書きます。ドキュメントサイトであれば、CSSのクラスや余白用のコンポーネントを使うほうがきれいに解決できます。
GitHubのREADMEで改行するには？
READMEはCommonMarkとして描画されるので、改行キー1回だけでは無視されます。行末に半角スペース2つかバックスラッシュを置くか、<br>を入れてください。改行キー1回でそのまま改行されるIssueやプルリクエストのコメント欄とは挙動が異なります。