Markdown(マークダウン)で技術ドキュメント、ブログ記事、README、メモ、議事録を作成していて、「Enterキーで改行したはずなのに、プレビューを見ると1行に繋がって表示されてしまう」「Markdownで改行されない・改行できない…」と困った経験はありませんか?
実は、「Markdown(md)で普通にEnterを押しても改行されない」という問題は、Markdown初心者が最もつまずきやすい代表的な仕様です。Markdown(マークダウン)では、一般的なワープロソフトやメモ帳とは異なり、単にEnterキーを1回押しただけでは改行タグ(<br> タグ)としてレンダリングされない基本ルールになっています。
しかしご安心ください。Markdownで改行・段落分け(md 改行)を行う方法は非常にシンプルで、主に「行末に半角スペース2つ」「HTMLの <br> タグ(markdown br)」「空行を挟む(Enter2回による段落分け)」の3つのパターンを覚えるだけで完全に解決できます。
この記事では、Markdownで改行する3つの解決策(早見表・チートシート付き)をはじめ、「なぜ通常のEnter1回ではMarkdownで改行されないのか」という原因と仕組み、VS Code・GitHub・Qiita・Notion・NotePMなどの主要ツール別の改行挙動差異、さらに表(テーブル)や箇条書き内での改行方法、全角スペースなどのよくある改行できないトラブルの対処法まで、わかりやすく徹底解説します!
📌 本記事のポイント・要点まとめ
- markdown 改行 されない原因: Markdown標準では「Enter1回=単なる単語の区切り(空白)」として処理される仕様のため
- 解決策1(スペース2つ): 行末に「半角スペース2個(
)」を入力すると同じ段落内で改行(<br>相当)される - 解決策2(HTMLタグ):
<br>タグを直接書けば、どのエディタ・環境でも確実に改行できる(markdown br) - 解決策3(markdown 段落分け): 「空行(Enter2回)」を挟むと、新しい段落(
<p>)として綺麗な余白付きで分割される - ツール別の違い: GitHubのIssueやQiitaなどはEnter1回で改行されるが、標準MarkdownやVS Codeはスペース2個または設定が必要
- テーブル内の改行: 表(テーブル)の中で改行したい場合は
<br>タグ(markdown br)が必須
【30秒で解決】Markdownで改行する3つの方法まとめ(早見表)
まずは「今すぐMarkdownの改行を反映させたい!」という方向けに、Markdownで改行・段落分け(md 改行)を行う3つの基本パターンを一覧表にまとめました。用途に合わせて使い分けてみてください。
| 方法・記法 | Markdownの書き方(入力例) | HTML変換結果 | 主な使いどころ |
|---|---|---|---|
| 1. 行末スペース2つ (Markdown標準改行) |
1行目のテキスト··2行目のテキスト※末尾に半角スペース2個(··) |
<p>1行目<br>2行目</p>同一段落内で改行 |
住所・詩・短い補足説明など |
| 2. <br> タグ (markdown br 記法) |
1行目のテキスト<br>2行目のテキスト |
<p>1行目<br>2行目</p>同一段落内で改行 |
表(テーブル)の中、空白消去を防止したい時 |
| 3. 空行(Enter2回) (markdown 段落分け・推奨) |
1段落目のテキスト
|
<p>1段落目</p><p>2段落目</p>段落が分かれ余白が付く |
通常の文章・ブログ本文・解説文など |
💡 【結論】マークダウン 改行のどれを使うべき?
基本的には「空行を1行空けて段落を分ける(markdown 段落)」のがWebライティングやドキュメント作成において最も読みやすく推奨されるスタイルです。同一段落内でどうしても行を変えたい場合や、表(テーブル)の中で改行したい場合は「<br>タグ(markdown br)」を使うと、スペースの見落としや自動削除トラブルを防げて安全です。
なぜEnter1回で改行されない?原因とMarkdownの基本仕様
「一般的なテキストエディタやSNSならEnterを押せば当然改行されるのに、なぜMarkdown 改行 されないのか?」「なぜ改行 できない仕様になっているのか?」と疑問に思う方も多いでしょう。
これには、Markdownという軽量マークアップ言語の設計思想とHTMLの変換ルールが深く関係しています。
原因1:Markdownは「段落(pタグ)」と「改行(brタグ)」を明確に区別している
HTMLなどのWeb言語では、文章の構造として以下の2つを厳密に区別しています。
- markdown 段落(Paragraph:
<p>タグ): 文章の意味的なまとまり。前後に適度な余白(マージン)が自動的に空く。 - 行の強制改行(Line Break:
<br>タグ): 同一の段落内で、余白を作らずに単に行を折り返す。
Markdownは「プレーンテキストを綺麗なHTML文書に変換するための仕組み」として開発されました。そのため、通常のEnterキー1回は「段落の終了」ではなく、「文章作成中の単なるソフトラップ(エディタ上の折り返し)」とみなされ、HTMLに変換される際には空白(半角スペース1個)として扱われる仕様になっています。そのため、Markdown 改行 されない状態になります。
💡 なぜ「Enter1回=空白」という仕様になったのか?
英語圏のプログラミングや文章作成では、ソースコードの可読性を保つために「1行80文字程度でEnterを押して適宜折り返す」という慣習があります。もしEnter1回で毎回改行(<br>)されてしまうと、ブラウザ表示時に不自然な位置でぶつ切りになってしまいます。そのため、「空行が入るまでは1つの段落として繋げてレンダリングする」という仕様が標準化されました。これが マークダウン 改行 できない原因です。
原因2:HTML変換結果(レンダリング)の具体的な違い
それぞれの書き方がどのようにHTMLに変換されるのかを比較してみましょう。md 改行の仕組みが直感的に理解できます。
❌ 1. Enterキーを1回だけ押した場合(markdown 改行 されない)
# Markdownの入力:
吾輩は猫である。
名前はまだ無い。
↓ HTML変換結果(1つのpタグ内にまとまり、改行タグが入らない):
<p>吾輩は猫である。 名前はまだ無い。</p>
実際のブラウザ表示: 吾輩は猫である。 名前はまだ無い。(※横に繋がってしまい改行 できない)
⭕ 2. 行末に半角スペースを2個入れた場合(同一段落内で改行)
# Markdownの入力(末尾にスペース2つ):
吾輩は猫である。
名前はまだ無い。
↓ HTML変換結果(brタグが挿入される):
<p>吾輩は猫である。<br>名前はまだ無い。</p>
実際のブラウザ表示:
吾輩は猫である。
名前はまだ無い。
⭕ 3. 空行(Enter2回)を挟んだ場合(markdown 段落分け)
# Markdownの入力(間に1行の空行):
吾輩は猫である。
名前はまだ無い。
↓ HTML変換結果(独立した2つのpタグに分かれる):
<p>吾輩は猫である。</p>
<p>名前はまだ無い。</p>
実際のブラウザ表示:
吾輩は猫である。
名前はまだ無い。(※段落間に適度な余白ができる)
「markdown 段落分け」と「同一段落内の改行」の使い分け基準
Markdown文書を読みやすくレイアウトする上で、以下の基準で使い分けるのがベストプラクティスです。
- 「段落分け(markdown 段落 / 空行)」を使う場面: ブログや技術記事、ドキュメントの本文。話題や意味のまとまりが変わるタイミングで空行を挟むことで、読者が疲れない自然な余白を作ることができます。
- 「改行(スペース2つ または markdown br)」を使う場面: 住所(郵便番号・都道府県・番地)、詩や歌詞、同一項目内の短い補足説明など、「段落としては1つにまとめたいが、行だけ折り返したい」場合に使用します。
Markdownで改行する具体的な3つの書き方・手順
ここからは、Markdown(md 改行)で実際に改行を行う3つの具体的な書き方とそれぞれのメリット・デメリットを詳しく解説します。
1. 行末に「半角スペース2つ」を入力する(Markdown標準記法)
Markdownの公式仕様(CommonMark / オリジナルMarkdown)で最も標準的な改行方法が、「行の末尾に半角スペースを2個(またはそれ以上)入力してからEnterを押す」という手法です。これで markdown 改行 が正しく反映されます。
📝 記述例(スペースを「␣」で可視化):
東京都千代田区千代田1-1␣␣
皇居前ビル 3階␣␣
電話番号:03-XXXX-XXXX
- メリット:
- Markdown本来の記法であり、HTMLタグを使わずにシンプルに書ける
- あらゆる標準Markdownパーサーで正しく認識される
- デメリット・注意点:
- スペースが見えない(不可視): エディタ上で空白が見えないため、スペースが入っているかどうかが一目で判断しにくい
- エディタの自動整形機能で削除されやすい: VS Codeなどの「末尾の空白を自動削除(Trim Trailing Whitespace)」機能がオンになっていると、ファイルを保存した瞬間にスペース2個が勝手に消されて markdown 改行 できない 原因になります
2. HTMLの「<br>タグ」を使う(markdown br / 確実・ミス防止に最適)
Markdownは「文章内にHTMLタグをそのまま記述できる(インラインHTML)」という強力な仕様を持っています。そのため、改行したい位置に直接 <br> または <br />(markdown br)を書き込むことで、確実に改行させることができます。
📝 記述例(markdown br):
第一章 はじめに<br>
本ドキュメントではMarkdownの仕様について解説します。<br>
更新日:2026年8月
- メリット:
- 視覚的に明確: コード上で改行の存在がはっきりと見えるため、修正やレビューがしやすい
- 自動削除されない: エディタの保存時フォーマッター(Trim Whitespace)に消される心配が一切なく、改行 できない トラブルを防げる
- テーブル(表)の中で使える: Markdownのテーブル構文内で改行できる唯一の方法
- デメリット:
- プレーンテキストとして見たときにHTMLタグが混ざるため、生のテキストの見た目がわずかに煩雑になる
3. 「空行(Enter 2回)」を挟んで段落を分ける(markdown 段落・推奨)
一般的なWeb記事やブログ、マニュアル、READMEなどでは、「空行を1行空けて段落を分ける(markdown 段落)」書き方が最も読みやすく、SEOやアクセシビリティの観点からも推奨されます。
📝 記述例(markdown 段落):
Markdownはテキストを素早く構造化できる軽量マークアップ言語です。
空行を1行挟むだけで、自動的に新しい段落(pタグ)として生成されます。
文章の区切りが視覚的にわかりやすくなり、スマートフォンでも読みやすくなります。
- メリット:
- PC・スマートフォンの画面幅に関わらず、適切な段落余白がついて読みやすい
- HTML構造として正しい
<p>タグが出力されるため、検索エンジン(SEO)やスクリーンリーダーにも好影響 - 特別な記号やスペースを意識せず、Enterを2回押すだけで直感的に書けるため md 改行 で悩まない
【補足】行末の「バックスラッシュ(\)」による改行(CommonMark仕様)
厳密な標準仕様であるCommonMarkでは、半角スペース2つの代わりに「行末にバックスラッシュ(\ / 日本語環境では円記号 ¥)」を置くことで改行できる仕様が策定されています。
1行目のテキスト\
2行目のテキスト
GitHubやVS Code、PandocなどのCommonMark準拠パーサーでサポートされています。末尾のスペースが消えてしまうのを防ぎつつ、HTMLタグを使いたくない場合の選択肢になります。
主要ツール・エディタ別の改行ルールの違い
Markdownを扱う環境によって、「Enter1回で改行されるかどうか」の挙動(ソフトブレイク / ハードブレイク)が異なります。主要なエディタやWebサービスごとの仕様を把握しておきましょう。
| ツール / サービス | Enter1回の挙動 | 必要な改行操作 | 仕様・特徴 |
|---|---|---|---|
| VS Code | 改行されない (デフォルト) |
スペース2個 / <br> / 空行 | 設定変更でEnter1回改行も可能 |
| GitHub(Issue / PR) | 自動で改行される | Enter 1回 | GFM仕様(ハードラップ有効) |
| GitHub(README.md) | 改行されない | スペース2個 / <br> / 空行 | リポジトリのREADMEは標準準拠 |
| Qiita / Zenn | 自動で改行される | Enter 1回 | 日本向け技術ブログとして最適化 |
| Notion | 新しいブロックになる | Shift + Enter で同一ブロック内改行 |
ブロック指向エディタの独自仕様 |
| Slack / Discord | メッセージ送信(Slack) / 改行 | Shift + Enter で改行(Slack) |
チャットツール独自の操作感 |
| NotePM / esa | 自動で改行される | Enter 1回 | 社内wiki向けに初心者フレンドリー設計 |
1. Visual Studio Code(VS Code)での設定方法
VS CodeでMarkdownをプレビューする際、標準では「スペース2個」を入れないと改行されません。しかし、設定を変更することでEnter1回の改行を有効にしたり、末尾スペースの自動削除を回避できます。
⚙️ VS CodeのプレビューでEnter1回改行を有効にする設定:
- VS Codeの設定(ショートカット:
Ctrl + ,またはCmd + ,)を開く - 検索バーに
markdown.preview.breaksと入力 - 「Markdown > Preview: Breaks」のチェックボックスをオンにする
settings.json に直接追記する場合:
"markdown.preview.breaks": true
2. GitHub(GFM)での改行仕様の違い
GitHubでは、書き込む場所によってMarkdownの改行仕様が異なります。
- Issue・プルリクエスト・Discussions: GitHub Flavored Markdown (GFM) の拡張仕様により、Enterキー1回を押すだけでそのまま改行(
<br>)として反映されます。 - リポジトリの
README.mdや Wiki: 標準的なMarkdown仕様に準拠しており、Enter1回では改行されません。スペース2つまたは<br>、空行を使う必要があります。
3. Qiita / NotePM / esa などの情報共有ツール
QiitaやNotePMなどの国内ナレッジ共有ツールでは、Markdownに不慣れな非エンジニアでも直感的に書けるよう、「Enter1回=改行」になるようパーサーが独自にカスタマイズされています。そのため、ブログ記事や社内wikiではスペース2個を意識せずにEnterだけで改行が反映されるケースが多いです。
4. Notion・Slack・Discordでの改行操作
ブロック型エディタやチャットツールではキーボード操作に注意が必要です。
- Notion: Enterキーを押すと「新しいブロック(段落)」が作成されます。同一ブロック内で単に改行したい場合は
Shift + Enterを押します。 - Slack: Enterキーは「メッセージ送信」になります。改行するには
Shift + Enterを押します。 - Discord: 通常の入力欄では
Shift + Enterで改行します。コードブロック内ではEnterキーでそのまま改行できます。
Markdownの改行・段落でよくあるトラブルと解決策
「指示通りに書いたはずなのにどうしてもMarkdownで改行されない」「なぜか意図しないレイアウト崩れが起きて改行 できない」といった際の原因と対処法をまとめました。
トラブル1:全角スペースが入っていて改行されない(改行 できない)
【原因】 日本語入力(IME)がオンの状態でスペースキーを2回押してしまい、「全角スペース( )」が入力されているケースです。Markdownのパーサーは全角スペースを改行記号として認識しないため、markdown 改行 されない 原因となります。
🔧 解決方法:
必ず英数(半角)入力モードに切り替えてから 半角スペースを2個( ) 入力してください。または、全角・半角の影響を受けない <br> タグ(markdown br)を使うのが最も確実です。
トラブル2:エディタ保存時に末尾スペースが勝手に消える
【原因】 VS Codeや各種IDEには、コードを綺麗に保つために「ファイル保存時に行末の余分な空白を自動削除する設定(Trim Trailing Whitespace)」が標準で備わっています。これが有効だと、せっかく入力したスペース2個が保存時に消滅してしまい、md 改行 できない状態になります。
🔧 解決方法(VS Codeの場合):
Markdownファイルのみ空白削除を無効化するように、settings.json に以下を設定します。
"[markdown]": {
"files.trimTrailingWhitespace": false
}
トラブル3:表(テーブル)のセル内で改行したい
【原因】 Markdownのテーブル(表)構文では、パイプ記号(|)と行の組み合わせで表を認識するため、セル内でEnterや半角スペース2個を使っても表自体が壊れてしまい、改行 できない 状態になります。
🔧 解決方法:
表のセル内で改行を行う唯一の方法は <br> タグ(markdown br)を記述することです。
| 機能名 | 説明 |
|---|---|
| 基本改行 | 行末スペース2個<br>または<br>タグを使用 |
| 段落分け | 空行を1行挟む |
トラブル4:箇条書き(リスト)の中で改行・複数行を書きたい
【原因】 箇条書きリストの途中で単にEnterを押すと、新しいリスト項目(別の行頭記号)になってしまうか、リストから抜けてしまい、意図通りに改行 されない 現象が起きます。
🔧 解決方法:
1つの箇条書き項目の中で改行して文章を続けたい場合は、次の行の先頭を「半角スペース4個(またはタブ)」でインデントします。
* 箇条書きの項目1
インデントすると項目1に属したまま改行されます。
空行を挟む場合も半角スペース4つを入れます。
* 箇条書きの項目2
トラブル5:Enterを何回も連打しても大きな余白(連続改行)ができない
【原因】 Markdownでは、空行を3行〜5行など何行連続で入れても、HTMLに変換される際には「単一の段落区切り」として1つの空行分に縮約(マージ)されます。
🔧 解決方法:
どうしても意図的に大きな空白行を作りたい場合は、<br><br> のように改行タグを連続で並べるか、<div style="margin-bottom: 40px;"></div> のようにHTML/CSSでマージンを指定します。
トラブル6:行頭にスペースを入れたら勝手にグレーの枠(コードブロック)になった
【原因】 Markdownの古い標準仕様により、「行頭に半角スペース4個以上を入れるとインデントコードブロックとして認識される」というルールがあるためです。
🔧 解決方法:
文章の先頭字下げを行いたい場合は、半角スペースではなく全角スペース( )を1個入れるか、CSSで text-indent を指定しましょう。
Markdown改行のベストプラクティス(どれを使うべき?)
ここまで紹介した複数の改行方法を踏まえ、日常のドキュメント執筆やチーム開発で迷わないための「実践的なMarkdown改行・段落使い分けルール」を提案します。
🏆 おすすめの運用ルール・指針
- 基本は「空行(Enter2回)による段落分け(markdown 段落)」をメインにする
Web文章は適度な段落余白がある方が圧倒的に読みやすいです。文章を詰め込みすぎず、2〜3文ごとに空行を入れて段落を分けましょう。 - 表の中や特殊な配置には「<br>タグ(markdown br)」を使う
Markdownテーブル内での改行や、設定ミスによる空白削除トラブルを防ぎたい場合は、視覚的に確実な<br>を使いましょう。 - チーム開発ではエディタ設定を統一する
GitHubのIssueやPRでのコメントはEnter1回で改行されますが、リポジトリの.mdファイルは標準仕様です。チーム内で.editorconfigや VS Codeの.vscode/settings.jsonを共有し、末尾空白の扱いを統一しておくとトラブルが防げます。
よくある質問(FAQ)
Q1. Markdownで改行できないとき、最も簡単で確実な対処法は何ですか?
A. 改行したい位置に直接 <br> と入力(markdown br)するか、Enterキーを2回押して「空行(markdown 段落分け)」を作るのが最も確実です。半角スペース2個は見落としやエディタの自動削除が起きやすいため、初心者のうちは <br> または空行を使うのがおすすめです。
Q2. <br> タグと半角スペース2個、SEOや表示速度に違いはありますか?
A. どちらも最終的にHTMLの <br> タグに変換されるため、SEO評価やページの表示速度に違いは一切ありません。ご自身の書きやすさやチームのコーディング規約に合わせて選択してください。
Q3. スマホやタブレットのエディタで半角スペース2個が入力しにくいときは?
A. スマートフォンのキーボードでは末尾の半角スペース入力がやりづらかったり、自動でピリオドに変換される機能が働く場合があります。スマホ環境で md 改行 を行う際は <br> を使うか、Enter2回による段落分けを活用するのがスムーズです。
Q4. 改行と段落でGoogle検索(SEO)の評価に差は出ますか?
A. 検索エンジンは段落(<p>)を文章の意味的な区切りとして認識します。むやみに1つの段落内で <br> を多用して長文を続けるよりも、意味の区切りごとに空行を入れて適切な markdown 段落 構造を保つ方が、SEO的にもコンテンツの論理構造が正しく評価されやすくなります。
まとめ|Markdownの改行・段落を使いこなして読みやすい文章を書こう
今回は、Markdownで改行されない原因と仕組み、そして「スペース2つ」「<br>タグ(markdown br)」「空行(markdown 段落分け)」という3つの解決策について徹底解説しました。
📌 今回のおさらい
- Enter1回で改行されないのは仕様: Markdown標準では段落(
<p>)と改行(<br>)が厳密に区別されているため markdown 改行 されない - 同じ段落内で改行したい時: 行末に「半角スペース2個」または「
<br>タグ」を使用する - 文章を区切って段落を分けたい時: 「空行(Enter2回)」を入れて新しい段落を作る(markdown 段落)
- 表(テーブル)の中での改行:
<br>タグ(markdown br)が唯一の解決策 - VS Codeやツール別の設定: プレビュー設定や自動空白削除の設定を確認・カスタマイズする
マークダウン 改行 と段落の使い分けをマスターすれば、ドキュメントの読みやすさと美しさが一段と向上します。ぜひ日々のMarkdown執筆に役立ててみてください!