Markdown(マークダウン)でドキュメントやREADME、技術ブログ、社内Wiki、メモを作成する際、情報を整理してわかりやすく伝えるために欠かせないのが「Markdown表(マークダウン表 / markdown table / markdownテーブル)」の作成です。
「Markdownで表を作成する基本的な書き方やパイプ記号の使い方を知りたい」「表の中のテキストを左揃え・中央揃え・右揃えに配置したい」「セル内で改行(表 改行 / <br>)する方法は?」「Markdown表でセル結合(markdown表 結合 / rowspan / colspan)はできる?」「Excelやスプレッドシートのデータを一発でMarkdownテーブルに変換できるジェネレーターツールを使いたい」といった疑問をお持ちではないでしょうか。
Markdownの表構文はパイプ記号(|)とハイフン(-)を並べるだけのシンプルな仕様ですが、セル内改行(表 改行)やセル結合(markdown表 結合)、文字装飾、エスケープ処理などの応用テクニックをマスターすることで、見やすく美しいプロ品質のドキュメントを素早く作成できるようになります。
この記事では、コピペですぐに使えるMarkdown表チートシートをはじめ、基本構文・テキスト配置(アラインメント)、セル内改行(表 改行)、セル結合(markdown表 結合)の代替HTMLコード、装飾・リンク埋め込み、おすすめのオンラインMarkdownテーブルジェネレーター、表が崩れる原因と対処法まで、徹底的にわかりやすく解説します!
📌 本記事のポイント・要点まとめ
- 基本構文:
|(パイプ)で列を区切り、2行目の|---|---|(ハイフン)でヘッダーとデータを分離する(markdown table / マークダウン表) - テキスト配置(文字揃え): 2行目にコロン
:を配置(:---左揃え /:---:中央揃え /---:右揃え) - セル内改行(表 改行): Markdownの改行(Enter)は効かないため、HTMLの
<br>タグを使用する - セル結合(markdown表 結合): 標準Markdownではセル結合不可。
rowspan/colspanを指定したHTMLの<table>タグで代用する - 表内の文字装飾: 太字(
**テキスト**)、リンク([名前](URL))、コード(`code`)、チェックボックス(- [ ])も挿入可能 - パイプ記号の表示: セル内に
|を文字として表示したい場合は\|とエスケープするか`|`と記述 - ジェネレーター活用: TablesGeneratorやTableConvertを使えばExcel/CSVから一発でMarkdownテーブルを生成可能
【コピペで使える】Markdown表(テーブル)の書き方早見表(チートシート)
まずは「今すぐMarkdown表(マークダウン表)を作りたい!」「構文をサクッとコピーしたい」という方向けに、実務で頻出するMarkdownテーブル記法(markdown table / markdownテーブル)の入力コードと表示例をまとめました。用途に合わせてコピー&ペーストしてご利用ください。
| テーブルの種類 | Markdown入力コード(コピペ用) | 特徴・利用シーン |
|---|---|---|
| 基本テーブル (左揃えデフォルト) |
| 項目 | 内容 | 備考 | |
最もシンプルな標準のMarkdown表構成 |
| 配置指定テーブル (左・中央・右揃え) |
| 左揃え | 中央揃え | 右揃え | |
コロン : で列ごとに文字位置を揃える(数値は右揃え推奨) |
| セル内改行 (表 改行) |
| 機能 | 説明 | |
<br> タグでセル内に複数行の文章を記述(表 改行の基本) |
| 文字装飾入り (太字・コード・リンク) |
| コマンド | 説明 | リンク | |
マークダウン表のセル内に太字・インラインコード・リンクを埋め込み |
| パイプ記号エスケープ | | 条件 | 記号 | |
表区切りと誤認させずに縦棒 | をセル内に表示 |
| セル結合(HTML代用) (markdown表 結合) |
<table><tr><th colspan="2">見出し</th></tr>...</table> |
横結合(colspan)や縦結合(rowspan)を実現(markdown表 結合の唯一の方法) |
Markdown表(テーブル)の基本構文と仕組み
Markdownにおける表(markdown table / マークダウン表)は、GitHub Flavored Markdown(GFM)やCommonMark拡張仕様で広く採用されている「パイプテーブル記法」を使用します。
基本構造は非常にシンプルで、以下の「3つのパーツ」で構成されます。
- ヘッダー行(1行目): 各列の見出し項目をパイプ
|で区切って記述 - 区切り行 / セパレータ(2行目): ハイフン
-を使ってヘッダーとデータ行を区切る(最低3つのハイフン---推奨) - データ行(3行目以降): セルごとのデータをパイプ
|で区切って記述
📝 基本テーブルの入力コード例
| 見出し1 | 見出し2 | 見出し3 |
| --- | --- | --- |
| データ1 | データ2 | データ3 |
| データ4 | データ5 | データ6 |
▼ レンダリング結果(実際のブラウザ表示):
| 見出し1 | 見出し2 | 見出し3 |
|---|---|---|
| データ1 | データ2 | データ3 |
| データ4 | データ5 | データ6 |
両端のパイプ(|)は省略できる?
多くのMarkdownパーサーでは、行頭と行末のパイプ | を省略して以下のように記述することも文法上許容されています。
見出し1 | 見出し2 | 見出し3
--- | --- | ---
データ1 | データ2 | データ3
⚠️ 実務でのおすすめ:両端のパイプは必ず付けよう
両端のパイプを省略すると、エディタによっては通常のテキストと誤認されて表に変換されないトラブルが発生します。また、コードの見た目(可読性)も悪くなるため、「行頭と行末にも必ず | を付ける」のがMarkdownテーブル作成の実務上のベストプラクティスです。
セルの幅(空白スペース)は揃えなくても大丈夫?
Markdownの表では、テキストエディタ上で列の幅をスペースで綺麗に揃えても、揃えずに詰めて書いても、ブラウザでのレンダリング結果はまったく同じになります。
# スペースで幅を揃えた場合(エディタで見やすい)
| 商品名 | カテゴリ | 価格 |
| ---------- | -------- | ------ |
| ノートPC | 家電 | 120000 |
| マウス | 周辺機器 | 3500 |
# スペースを詰め合わせた場合(入力が速い)
| 商品名 | カテゴリ | 価格 |
| --- | --- | --- |
| ノートPC | 家電 | 120000 |
| マウス | 周辺機器 | 3500 |
手動でスペースを揃えるのは大変ですが、後述するVS Codeの拡張機能や自動整形ツール(ジェネレーター)を使えば、一瞬で見た目を美しく整えることができます。
テキストの配置・文字揃え(左揃え・中央揃え・右揃え)
Markdown表の列ごとのテキスト配置(アラインメント)は、2行目のセパレータ(区切り行)にコロン : を記述することで制御します。
| 配置(揃え方) | セパレータの書き方 | 主な使い分け |
|---|---|---|
| 左揃え(Left) (デフォルト) |
:--- または --- |
一般的なテキスト、名前、説明文、文章など |
| 中央揃え(Center) | :---: |
ステータス(OK/NG)、日付、区分、記号、短い文字 |
| 右揃え(Right) | ---: |
数値、金額(価格)、数量、スコア、パーセンテージ |
📝 配置指定の実例コード
| 商品名(左揃え) | 発売日(中央揃え) | 在庫状態(中央揃え) | 価格(右揃え) |
| :--- | :---: | :---: | ---: |
| ワイヤレスマウス | 2025-04-10 | あり | ¥3,480 |
| メカニカルキーボード | 2025-06-01 | 残りわずか | ¥15,800 |
| 4Kモニター 27インチ | 2025-08-15 | 完売 | ¥49,800 |
▼ レンダリング結果:
| 商品名(左揃え) | 発売日(中央揃え) | 在庫状態(中央揃え) | 価格(右揃え) |
|---|---|---|---|
| ワイヤレスマウス | 2025-04-10 | あり | ¥3,480 |
| メカニカルキーボード | 2025-06-01 | 残りわずか | ¥15,800 |
| 4Kモニター 27インチ | 2025-08-15 | 完売 | ¥49,800 |
💡 見やすさを高める配置のコツ:
価格や数量などの「数値データ」を右揃えに設定すると、桁数が綺麗に揃って直感的に比較しやすくなります。日付やステータス区分は中央揃え、長めの文章や名称は左揃えにするのがマークダウン表作成の基本テクニックです。
需要の高い応用テクニック5選(改行・結合・装飾・コード・エスケープ)
基本的なMarkdownテーブルが作れるようになったら、実務で絶対に役立つ5つの応用テクニックをマスターしましょう。
1. セル内で改行する方法(表 改行 / <br> タグの使用)
Markdownの表のセル内で通常の Enter キーを押して改行してしまうと、構文が破壊されてテーブルとして認識されなくなります。セル内で文章を複数行に折り返して表示したい(表 改行を行いたい)場合は、HTMLの <br>(または <br />)タグを直接記述します。
📝 セル内改行(表 改行)の入力コード例
| プラン名 | 料金 | 主な機能(セル内改行) |
| :--- | :---: | :--- |
| フリー | 無料 | ・ユーザー数:1名<br>・ストレージ:5GB<br>・基本サポートのみ |
| スタンダード | ¥980/月 | ・ユーザー数:無制限<br>・ストレージ:100GB<br>・24時間チャットサポート |
▼ レンダリング結果:
| プラン名 | 料金 | 主な機能(セル内改行) |
|---|---|---|
| フリー | 無料 | ・ユーザー数:1名 ・ストレージ:5GB ・基本サポートのみ |
| スタンダード | ¥980/月 | ・ユーザー数:無制限 ・ストレージ:100GB ・24時間チャットサポート |
💡 リスト風の表示にも最適:
セル内に箇条書きを入れたい場合、Markdownの通常のリスト構文(- 項目)は表内では使えませんが、・ 項目1<br>・ 項目2 のように中黒と <br> を組み合わせることでスッキリしたリストを作成できます(表 改行の王道テクニック)。
2. セル結合(markdown表 結合 / 横・縦)の可否と代替HTML(colspan / rowspan)
多くの人が「Markdown表でセル結合(markdown表 結合)はどう書くの?」と探しますが、残念ながらGitHub Flavored Markdown(GFM)やCommonMarkなどの標準Markdown記法にはセルを結合する構文は存在しません。
そのため、横方向の結合(列結合)や縦方向の結合(行結合)を行いたい場合は、Markdown文書の中に直接HTMLの <table> タグを記述するのが標準的かつ唯一の解決方法です。
| 結合の種類 | 使用する属性 | 記述例 |
|---|---|---|
| 横方向の結合(列結合) | colspan="結合数" |
<th colspan="2">2列分結合</th> |
| 縦方向の結合(行結合) | rowspan="結合数" |
<td rowspan="2">2行分結合</td> |
📝 セル結合(markdown表 結合)を含むHTMLテーブルの記述例(コピペ用)
<table>
<thead>
<tr>
<th rowspan="2">大区分</th>
<th colspan="2">詳細情報</th>
</tr>
<tr>
<th>品目</th>
<th>価格</th>
</tr>
</thead>
<tbody>
<tr>
<td rowspan="2">果物</td>
<td>りんご</td>
<td>¥150</td>
</tr>
<tr>
<td>バナナ</td>
<td>¥120</td>
</tr>
<tr>
<td>野菜</td>
<td>トマト</td>
<td>¥200</td>
</tr>
</tbody>
</table>
▼ レンダリング結果:
| 大区分 | 詳細情報 | |
|---|---|---|
| 品目 | 価格 | |
| 果物 | りんご | ¥150 |
| バナナ | ¥120 | |
| 野菜 | トマト | ¥200 |
💡 HTMLタグを手書きするのが大変なときは?
後述する「TablesGenerator.com」などのオンラインテーブルジェネレーターを使えば、GUI上でセルを選択して結合ボタンを押すだけで、上記のようなHTMLコードを自動生成してコピーできます(markdown表 結合の手間を大幅削減)。
3. テーブル内での文字装飾(太字・リンク・画像・チェックボックス)
Markdownの表のセル内では、さまざまなMarkdownインライン記法をそのまま適用できます。強調表示や関連ドキュメントへのリンク、チェックリストなどを組み合わせることで、情報密度の高いリッチなテーブルを作成できます。
📝 各種装飾を埋め込んだテーブルの入力例
| 装飾の種類 | 記法コード | 表示サンプル |
| :--- | :--- | :--- |
| **太字** | `**強調テキスト**` | **重要データ** |
| *斜体* | `*斜体テキスト*` | *Italic Text* |
| ~~取り消し線~~ | `~~削除テキスト~~` | ~~旧価格 ¥2,000~~ |
| [リンク](https://example.com) | `[サイト名](URL)` | [Google公式サイト](https://www.google.com) |
| タスクリスト | `- [x]` / `- [ ]` | [x] 完了 / [ ] 未着手 |
▼ レンダリング結果:
| 装飾の種類 | 記法コード | 表示サンプル |
|---|---|---|
| 太字 | **強調テキスト** |
重要データ |
| 斜体 | *斜体テキスト* |
Italic Text |
~~削除テキスト~~ |
||
| リンク | [サイト名](URL) |
Google公式サイト |
| タスクリスト | - [x] / - [ ] |
☑ 完了 / ☐ 未着手 |
4. インラインコードとコードブロックの埋め込み
技術仕様書やコマンドリファレンスを作成する場合、Markdown表の中にコマンドやソースコードを埋め込みたいケースが多くあります。
- 1行のコード(インラインコード): バッククォート
`コード`で囲みます。 - 複数行のコード: バッククォート3つのコードブロック(
```)は表内では使えないため、<pre><code>コード</code></pre>タグを使用するか、インラインコードと<br>を併用します。
📝 コード埋め込みテーブルの入力例
| Gitコマンド | 説明 | 実行オプション例 |
| :--- | :--- | :--- |
| `git commit` | 変更を記録 | `git commit -m "メッセージ"` |
| `git checkout` | ブランチ切り替え | `git checkout -b 新ブランチ名` |
| `git log` | コミット履歴表示 | `git log --oneline --graph` |
5. パイプ記号「|」そのものをセル内に表示する(エスケープ)
正規表現やプログラムの論理和(OR演算子 |)、コマンドラインのパイプラインなどをマークダウン表のセル内に書きたい場合、そのまま | を入力すると「列の区切り」と誤認されて表が崩れてしまいます。
セル内でパイプ記号を表示するには、以下の3つの方法のいずれかを使用します。
| エスケープ方法 | 記述方法 | 解説・おすすめ度 |
|---|---|---|
| バックスラッシュ(推奨) | \| |
最も標準的で直感的なエスケープ方法(⭐⭐⭐) |
| バッククォート囲み | `|` または `\|` |
コードとして表示したい場合に便利(パーサー依存あり) |
| HTMLエンティティ | | または | |
どのようなMarkdown環境でも確実に | を表示可能 |
# バックスラッシュでエスケープする例
| 演算子 | 意味 | 使用例 |
| :---: | :--- | :--- |
| `\|\|` | 論理OR | `if (a \|\| b)` |
| `\|` | ビットOR / パイプ | `cat file.txt \| grep word` |
Markdown表を爆速作成!おすすめオンラインジェネレーター&ツール4選
行数や列数が多い大きな表や、Excel・スプレッドシートのデータを手作業で1つずつ | で区切って入力するのは非常に非効率です。
ここでは、ExcelやCSVのデータを一発でMarkdown表(markdown table / markdownテーブル)に変換できるおすすめツール・ジェネレーターを4つ紹介します。
1. TablesGenerator.com(定番の無料オンラインテーブルジェネレーター)
Webブラウザ上でExcelのように表を作成・編集できる世界で最も有名なMarkdownテーブルジェネレーターです。
- 特徴: セルを選択して文字揃えや太字設定、行・列の追加削除がマウス操作で完結
- Excel連携: 「File」→「Paste table data」でExcelやスプレッドシートのセルをそのまま貼り付け可能
- セル結合サポート: セル結合を行いたい場合、上部メニューを「HTML Tables」に切り替えるだけで結合タグ付きHTMLを自動出力
- URL: TablesGenerator.com (Markdown Tables)
2. TableConvert.com(万能フォーマット相互変換ツール)
CSV、Excel、JSON、HTML、SQLなど、あらゆるデータ形式とMarkdownテーブルを双方向に相互変換できる高機能Webツールです。
- 特徴: CSVファイルをドラッグ&ドロップするだけで即座にMarkdownテーブルを生成
- 出力フォーマット多数: Markdownだけでなく、GFM形式、HTML、LaTeX、JSONへのワンクリック出力に対応
- URL: TableConvert.com
3. NotePM / GROWI などのWikiツール組み込みエディタ
社内情報共有ツールやナレッジ管理ツールの中には、高度なMarkdown表作成UIが標準搭載されているものがあります。
- NotePM: ツールバーからテーブルを選択するとExcelライクなエディタが起動。スプレッドシートからのコピペ自動変換にも対応
- GROWI: 「Handsontable」プラグインが組み込まれており、スプレッドシート画面でドラッグ&ドロップ編集して自動Markdown挿入が可能
4. VS Code拡張機能(Markdown Table Prettifier等)
日常的にVS Code(Visual Studio Code)でMarkdownを書くエンジニアやライターには、拡張機能の導入が圧倒的におすすめです。
- Markdown Table Prettifier / Prettier: 保存時やショートカットキー(
Shift + Alt + F)で、ガタガタの表のパイプ位置を自動で等幅に整列 - Excel to Markdown table: Excelのコピーデータを
Shift + Alt + Vで一発Markdown表として貼り付け - Visual Table Canvas for Markdown: VS Code内でExcelのようなGUIスプレッドシート画面を開いて直感編集
Markdown表が崩れる・表示されない原因と対策(トラブルシューティング)
「Markdownで表を書いたのに、プレビューで表にならず生の記号がそのまま表示される」「列の位置がズレてレイアウトが崩れてしまう」という場合は、以下の5大チェックポイントを確認してください。
❌ よくある原因1:表の前後に「空行(改行)」がない
直前の文章のすぐ次の行に | 見出し | を書き始めると、表ではなく通常の段落(パラグラフ)の一部と判定されてレンダリングされません。必ず表の直前と直後に1行の空行を入れてください。
❌ よくある原因2:セパレータ行(2行目)のハイフン不足・ハイフン抜け
2行目の区切り線(| --- | --- |)がない、またはハイフンが足りない場合、表として認識されません。各列に最低3つのハイフン --- を配置しましょう。
❌ よくある原因3:セル内のパイプ記号(|)がエスケープされていない
文章やコードの中に | がそのまま入っていると、パーサーが新しい列と解釈して列数が合わなくなり、全体のレイアウトが大きく崩れます。必ず \| でエスケープしてください。
❌ よくある原因4:全角パイプ(|)や全角スペースが混ざっている
日本語入力モードのまま |(全角縦線)や (全角スペース)を入力してしまうと、Markdown構文として認識されません。構文記号はすべて半角で統一してください。
❌ よくある原因5:各行の列数(セルの個数)が一致していない
ヘッダーが3列あるのにデータ行が2列または4列になっていると、テーブルの描画が乱れる原因になります。空のセルであっても | データ1 | | データ3 | のようにパイプを残して列数を一致させましょう。
主要ツール・プラットフォーム別のMarkdown表対応状況
Markdownの表記法は多くのWebサービスやエディタで標準サポートされていますが、ツールによって挙動や対応機能に若干の違いがあります。
| ツール / プラットフォーム | Markdown表対応 | 特徴・サポート機能 |
|---|---|---|
| GitHub / GitLab | ⭕ 完全対応 | GFM準拠。アラインメント、セル内改行(<br>)、埋め込み装飾をフルサポート |
| Qiita / Zenn | ⭕ 完全対応 | 技術記事向けにパイプテーブルやHTMLテーブル(結合)を綺麗にレンダリング |
| Notion | ⭕ 独自テーブル | Markdown貼り付けで「シンプルテーブル」に自動変換。列のドラッグや直感編集が可能 |
| Obsidian / Bear / Typora | ⭕ 完全対応 | 高機能Markdownエディタ。Obsidian 1.5以降はGUIテーブル編集機能も標準搭載 |
| VS Code | ⭕ 標準プレビュー | 標準プレビューに対応。拡張機能でフォーマット整形やGUI編集が極めて快適 |
| Slack / Discord | 🔺 非対応(制限あり) | チャットのMarkdownでは表記法がレンダリングされないため、コードブロック(```)で等幅テキスト表示するか画像で共有 |
まとめ:Markdown表を使いこなして見やすいドキュメントを作成しよう
Markdownの表(テーブル / マークダウン表 / markdown table)は、パイプ | とハイフン - だけで構造化データを表現できる非常に強力で便利な記法です。
🎯 Markdown表作成の振り返りポイント
- 基本:
| 見出し |と| --- |で列を定義する - 配置: 2行目のコロン(
:---左揃え /:---:中央揃え /---:右揃え)で視認性を劇的アップ - 改行(表 改行): セル内では
<br>タグを使用する - 結合(markdown表 結合): 複雑な表結合はHTMLの
<table>タグ(colspan/rowspan)で代用する - 効率化: TablesGeneratorやVS Code拡張機能などのジェネレーターを上手に活用する
本記事の逆引きチートシートやコピペ用コードをぜひブックマークして、日々のドキュメント作成やブログ執筆、README作成に役立ててください!
あわせて読みたいMarkdown関連記事
Markdownの各種記法や応用テクニック、表示崩れのトラブルシューティングについては、以下の関連ガイドもあわせてご活用ください。
- 【コピペで使える】Markdown記法一覧・チートシート|基本の書き方から応用・早見表まで完全網羅
- Markdown テーブル応用術:データ整形と可視化の実践ガイド
- Markdown表が崩れる原因と対策:テーブルレイアウトを安定させる5つのコツ
- Markdownでの改行方法を徹底解説:初心者でも簡単に使いこなそう
- 【コピペで使える】Markdownリンクの書き方完全ガイド|ページ内リンク・別タブ・相対パス・画像リンクまで網羅
- 【コピペで使える】Markdown画像挿入の完全ガイド|サイズ変更・リンク化・ローカル指定・トラブル対処まで網羅
- 【コピペで使える】Markdownチェックボックスの書き方完全ガイド|VSCode設定・表内の配置・できない時の対処法