Markdownの改行が反映されない原因と3つの対処法

公開ツールMarkdown → HTML変換

目次
  1. Enterを押しても改行されない理由
  2. 改行を確実に入れる方法
  3. よくつまずくポイント
  4. まとめ
  5. よくある質問

マークダウンエディタでEnterを1回押して行を分けたのに、変換後の結果ではその改行が消えて文が1行にくっついてしまうことがあります。これはエラーではなく、マークダウン標準(CommonMark)が定めた動作です。どんな場合に改行が消えるのか、どうすれば確実に改行できるのかをまとめます。

まとめ ① マークダウンの段落内でEnterを1回押す(ソフトブレーク)と、基本的には改行ではなくスペース1つとして処理されます。 ② 確実に改行するには、空行で段落を分ける、行末にスペースを2つ残す、または変換ツールのbreaksオプションが有効になっている必要があります。 ③ 変換後のHTMLに<br>タグがあるかどうかを見れば、どの方式が適用されたか確認できます。

Enterを押しても改行されない理由

メモ帳やマークダウンエディタで案内文を書くとき、行ごとにEnterだけを押して項目を区切る人が多いものです。イベントの日付、会場、問い合わせ先を1行ずつ書く、といった書き方です。

このテキストをHTMLに変換してブログや掲示板に載せると、行ごとに分けて書いた内容がスペース1つだけを残して1つの文にくっついてしまいます。確かにEnterは押したのに、改行が反映されていないように見えるのです。

これはエディタや変換ツールが故障しているのではなく、マークダウンがそもそも「段落内の改行1回」を改行として扱わないように設計されているためです。

改行を確実に入れる方法

マークダウン標準(CommonMark)では、1つの段落は複数行のテキストをひとまとめにしてレンダリングします。その中のEnter1回(ソフトブレーク)は改行ではなく、スペース1つに置き換わります。

改行を確実に入れる方法は3つあります。1つ目は、行の間に空行を1つ入れて、そもそも別の段落(<p>)として分ける方法です。2つ目は、行末にスペースを2つ残す方法で、その行だけがハードブレーク(<br>)に変わります。

3つ目は、チャット画面やコメント欄のようにEnter1回ですぐ行が変わる画面の場合で、変換ツールの「breaks」拡張オプションが有効になっています。このオプションが有効だと、段落内の改行がすべて<br>に変わります。

どの方式が実際に適用されたかは、変換後のHTMLコードを開いて、行の間に<br>タグがあるかどうかを目で確認すればわかります。

無料ツールで確認する。 手作業で空行を入れたり、スペースを2つ数えながら調整したりしなくても、入力したテキストがどう改行されるのかをプレビューとHTMLコードでその場で確認できます。この変換ツールはbreaksオプションが有効になっているので、段落内でEnterを1回押すだけで、すぐに<br>として反映されます。

Markdown → HTML変換

無料・登録不要・ブラウザ内だけで変換(サーバー送信なし)

よくつまずくポイント

状況原因
1行ずつEnterで区切ったのに、結果は1行にくっつくソフトブレークは基本的にスペース1つとして処理される(CommonMarkの既定ルール)
行末にスペースを2つ入れても変わらないエディタやメッセンジャーが保存・送信の際に行末のスペースを自動で消してしまう
表(テーブル)のセル内では改行できない表の記法は1行を1行分のテキストとして解析するため、セル内の改行自体が不可能
コードブロック内の改行はそのまま維持されるコードブロックは原文をそのまま保持する領域なので、ソフトブレークのルールが適用されない

まとめ

マークダウンの段落内でEnterを1回押すと、改行ではなくスペース1つとして処理されるのが標準のルールです。確実に改行するには、空行で段落を分ける、行末にスペースを2つ残す、または変換ツールのbreaksオプションが有効になっている必要があります。

同じテキストでも変換ツールの設定によって結果が変わるので、変換後のHTMLに<br>タグがあるかどうかを確認するのがもっとも正確な方法です。

Markdown → HTML変換

無料・登録不要・ブラウザ内だけで変換(サーバー送信なし)

よくある質問

マークダウンで確実に改行するにはどうすればいいですか?

空行を1つ入れて別の段落に分けるのがもっとも確実です。段落を保ったまま行だけ変えたい場合は、行末にスペースを2つ残せばよいのですが、多くのエディタは保存時にこのスペースを自動で消してしまうため、目で確認したほうが安全です。

breaksオプションが有効な変換ツールと無効な変換ツールは何が違いますか?

breaksオプションが有効だと、段落内のEnter1回もすぐに<br>タグに変わります。無効の場合はCommonMarkの既定ルールどおり、Enter1回はスペースにまとめられ、空行があって初めて新しい段落が生まれます。

表のセル内ではなぜ改行できないのですか?

マークダウンの表の記法では、|で区切った1行を1行分のテキストとして解釈します。その行に実際の改行文字が入ると表の構造そのものが壊れてしまうため、セル内で改行したいときは<br>というHTMLタグを直接書く必要があります。

コードブロック内の改行も消えますか?

いいえ。コードブロック(バッククォート3つで囲んだ部分)は原文をそのまま保持する領域なので、ソフトブレークのルールは適用されず、書いた改行がそのまま維持されます。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. マークダウン表の中央揃えは区切り線のコロンで決まるマークダウン表の中央・右揃えが、セル内の空白ではなくヘッダー下の区切り線のコロン位置で決まる仕組みを解説します。表が崩れる原因と正しい書き方もわかります。
  2. マークダウン表をExcelで開けるCSVに変換する方法NotionやGitHubのマークダウン表をExcelに貼り付けると崩れる理由と、区切り線やエスケープされたパイプまで整理してCSVへ正確に変換する方法を説明します。
  3. 議事録の書き方|議題・決定事項・アクションアイテムの残し方議題だけの議事録は後で使えません。議題・決定事項・アクションアイテムを分け、担当者と期限を添える書き方と、自動で整えるツールの使い方をまとめました。
  4. プレスリリース 5W1Hの書き方|タイトルとリード文の順序プレスリリースのタイトルと最初の段落に、5W1Hをどの順番で置けば記者に読まれるかを解説。よくある失敗と、事実だけで書くためのコツが分かります。
  5. 提案書の目次構成|事業タイプ別の標準順序提案書の目次が自由に決められない理由と、IT構築・マーケティング・提携・公共入札の4タイプ別の標準構成、発注元が目次を指定した場合の優先順位をまとめました。
  6. SQL INSERT CSV変換でNULLと空文字を区別する方法SQL INSERT文をCSVに変換すると、NULLと空文字が同じ空欄に見えがちです。変換時に区別する手順と、CSV側で区別が保たれているか確認する方法を整理します。

関連ツール