Markdown 表セルで改行する方法（GFM・PDF 崩れ防止）

GFM の表セル内改行には `<br>` タグが最も一般的です。サニタイズで消える原因、横幅オーバーへの対処、PDF で崩れにくい表の書き方と、長文を表から外に出す代替設計を解説します。

この記事でわかること

  • GFM（GitHub Flavored Markdown）の表セル内で改行する主な方法
  • <br> がサニタイズで消えるケースと確認方法
  • 横方向の幅とページ幅超えの問題への対処
  • PDF や印刷で崩れにくい表の設計ポイント
  • セルが長くなる場合の代替レイアウト（表以外のブロック）

Markdown の表は、列と行を | と - で表現するシンプルな記法が普及していますが、セルの中で改行したいというニーズに、素の記法だけでは応えにくいことがあります。GitHub Flavored Markdown（GFM）では、セル内に HTML の <br> を埋め込めるため、これがもっとも一般的な解決策のひとつです。ただし、ツールによってはサニタイズで HTML が除去されるため、「ローカルでは見えるが、本番のポータルでは消える」といった差も起こり得ます。

セル内で改行する主な方法

方法1：<br> タグを使う

セル内のテキストの途中に <br> を書くと、多くの GFM 対応レンダラではその位置で改行されます。

| 項目 | 説明 |
|------|------|
| 手順 | ファイルを開く<br>内容を確認する<br>保存して閉じる |

注意点：

  • セキュリティポリシーで HTML が禁止されている環境では使えない
  • アクセシビリティの観点で、極端に細かく改行しすぎると読みにくくなる

方法2：表現を変えて改行不要にする

長い説明文を1セルに詰め込むのではなく、行を分けて別の行として表に載せる、あるいは表の外に箇条書きとして出す、と情報設計を変えると、PDF でもレイアウトが安定しやすいです。特に業務資料では「見た目の表」より「読み手が迷わない構造」を優先する判断が効きます。

方法3：幅と折り返しを考慮する

A4 1枚の中で列数が多いと、各セルの幅が狭くなり、英数字の長いトークンが折り返されずに突き抜けることがあります。<br> で縦に積んでも、横方向の総長がページを超える場合は、列を減らす・横書きをやめる・フォントを小さくする、といった対策が必要になります。

PDF で崩れにくくするコツ

印刷や PDF では、画面のピクセル幅とは限りません。次の3つを基本とします。

  • 列数を抑える：A4横幅で読めるセル幅を意識する
  • ヘッダー行を固定しすぎない：長すぎる見出しは折り返しに影響する
  • セル内にコードブロックや画像を詰め込みすぎない：行数が増えてページをまたぎやすくなる

出力前に Markdown を PDF に などでプレビューし、はみ出しがないか確認する習慣があると、手戻りが減ります。

表以外の選択肢

セル内を何行にも分けたくなるほど長い説明は、そもそも表に載せない方が読みやすい場合があります。見出し＋箇条書き、番号付きリスト、定義リスト風の並び、といった別構造と比較してから表にする、と決めると、スマホ表示や印刷の両方で破綻しにくくなります。会議資料では「一覧表は短く、詳細は次ページの説明へ回す」といった分割も有効です。

メンテナンスの観点

<br> を多用すると、あとから行を追加したときに改行位置の調整が面倒になることがあります。チームで表を共同編集するなら、「セル内は1行に近い短文に限定する」などのルールを決め、長文は脚注や別セクションに逃がす運用も検討してください。Excel から表をコピーして Markdown に貼る場合は、結合セルや改行付きセルがそのまま移らないことが多いので、貼り付け後に必ずプレビューで崩れを確認しましょう。

よくある質問（FAQ）

Q. 表のセルに <br> を書いたのに改行されません

次の点を確認してください。

  1. 使用しているツール・サイトが HTML タグを許可しているか（サニタイザによって除去される場合があります）
  2. GFM（GitHub Flavored Markdown）に対応したパーサを使っているか
  3. <br> の前後にスペースがない形で書かれているか

Q. PDF にすると表がページをまたいで分断されます

Markdown を PDF に のレイアウト設定で「表の途中で改ページしない」を有効にしてください。また、列数や行数が多い表は A4 横向きで出力するか、表を分割することも検討してください。

Q. セル内の <br> は行末スペース2つで代替できますか？

GFM の表セル内では行末スペース2つによるハード改行は通常機能しません。表セル内の改行には <br> が最も信頼できる方法です（HTML が許可されている環境限定）。

Q. Excel からコピーした表に改行が入っていました

Excel のセル内改行は Markdown にそのまま移りません。貼り付け後に必ずプレビューで確認し、必要なら <br> に置き換えてください。

Q. モバイル表示で表が崩れます

列数が多い表は狭い画面で横スクロールが必要になります。モバイルを意識する場合は列数を減らすか、縦型のリスト形式に変更することを検討してください。

まとめ

セル内改行は <br> が手軽ですが、ツールの HTML 許可と横方向の幅に注意してください。長文は表以外のブロックも検討し、レイアウト全体のバランスで崩れを防ぎましょう。最終チェックでは、スマホ幅のプレビューとA4 印刷プレビューの両方を見ると、表の利用可否を判断しやすくなります。

ツールで試す

Markdown を HTML に で表のレンダリングを確認し、続けて Markdown を PDF に で印刷想定の見え方を確認する、という二段階がおすすめです。

関連記事