MD ViewerMD Viewer

100% プライベート — すべてブラウザ内で処理

マークダウン 改行 — ソフト改行と段落の違いを実演

Enterを1回押しても何も起きない、2回押すと段落が生まれる。マークダウン 改行の挙動をライブで試して、自分の改行がどこに入るか正確に確認できます。

MD Viewer チーム

例
Markdownソース
プレビュー

First line Second line

マークダウン 改行の規則は全員を驚かせます。行末でEnterを押しても、レンダリングされたテキストは同じ段落の中をそのまま流れ続けます。これはバグではありません。CommonMarkでは単一の改行はソフトブレイクであり、レンダラーが組版時にその行を結合してよいことになっています。本当に表示上の区切りとなるマークダウン 改行、つまり新しいブロックを始めるものには、段落のための空行か、ハードブレイクのための行末マーカーが必要です。

上のプレイグラウンドがその違いを物理的に示します。「1回の改行」の例にはEnter1つで隔てられた2行が入っており、プレビューがそれらを1つの流れるような段落に融合させる様子が分かります。「空行」の例に切り替えると、同じテキストが間隔を挟んだ2つの段落に分割されます。何を編集してもプレビューは即座に更新されるため、マークダウン 改行の挙動を、規則の暗記ではなく感覚で覚えられます。

このページの主眼は段落の問題、つまりマークダウン 改行が文書構造に何をするかです。同じ段落の中で折り返しを強制したい場合——住所、詩の行、ショートカット一覧——には、マークダウン 強制改行のページがスペース2つとバックスラッシュのハードブレイクを扱います。両ページとも同じエンジンをブラウザ内で実行し、アップロードもアカウントも不要です。

マークダウン 改行のチートシート

入力レンダリング結果
1行目 2行目1つの段落。改行は消えるソフトブレイク
1行目 2行目2つの段落。空行が本当のマークダウン 改行ブロックを作る
1行目 2行目スペース2つによるハードブレイク付きの1段落
1行目\ 2行目バックスラッシュによるハードブレイク付きの1段落
1つ 2つ2つの段落。空行を重ねても間隔は増えない

マークダウン 改行の正しい入れ方

  1. 1

    目的を決める

    新しい段落か、段落内の折り返しか。文章にとってのマークダウン 改行は段落であり、詩や住所には同じブロック内のハードブレイクが正解です。

  2. 2

    段落にはEnterを2回

    空行が新しいブロックを始めるマークダウン 改行です。2つの空行の間は、中に単独の改行がいくつあっても1つの段落です。

  3. 3

    ライブプレビューで確認

    上のチップで単独改行と空行を切り替え、プレビューペインを見ます。マークダウン 改行の挙動は、読むよりも見るほうが速く身につきます。

  4. 4

    Enterの連打は避ける

    空行を重ねても無意味です。レンダラーは連続する空行を1つの段落間隔に畳みます。ブロックを1つ作るマークダウン 改行の構文は、空行1行で完結します。

マークダウン 改行がデフォルトで折らない理由

Markdownはリフローする文章のために設計されました。同じ段落が携帯画面でもワイドモニターでも美しく折り返されるべきです。単一のEnterすべてが可視の改行を生んだら、端末から貼り付けたテキストやエディタに折り返された文章は破片に砕けます。だからマークダウン 改行の規則は、1つの改行をレンダラーが無視してよい提案として扱い、レイアウトの単位を行ではなく段落に置いたのです。

一部のプラットフォームは異なります。GitHubのコメント欄、チャットアプリ、いくつかのWikiフレーバーは、メッセージの入力習慣に合わせて単独改行をハードブレイクとして表示します。この分裂こそ、このページが標準CommonMark解釈でレンダリングする理由です。 strict なレンダラーへ文書が移っても挙動が予測できます。段落内の折り返しどこでも必要な場合は、マークダウン 強制改行ページの明示的な構文が答えです。

マークダウン 改行:入れるべきものと避けるべきもの

バラは赤い スミレは青い

バラは赤い スミレは青い

単独改行で隔てられた文は1つの段落に融合します。空行がそれぞれの文に独立したブロックを与えます。

間隔用に 5つの改行

空行 1つ

余分な空行は畳み込まれます。マークダウン 改行の間隔はレンダラーのスタイルシートが決め、Enterの回数では決まりません。

Shift+Enterで改行を期待

スペース2つかバックスラッシュ

MarkdownのソースにShift+Enterは存在しません。段落内のハードブレイクにはマークダウン 強制改行ページの明示的な構文を使います。

段落は飾りではなく構造

マークダウン 改行を構造上の決定として考えてください。空行は新しい考えの始まり、ソフト改行は同じ考えの継続です。スクリーンリーダー、アウトラインツール、PDFエクスポートはすべて段落の境界を使います。ソースの整形された段落構造は、そのまま他のすべての場所の整形された文書構造になります。

よくある質問

出典と仕様引用

“A regular line ending (not in a code span or HTML tag) that is not a hard line break is a soft line break.”
CommonMark Specification 0.31.2
“The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible.”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

関連するMarkdownツール