【コピペで使える】Markdown表(テーブル)の書き方完全ガイド|配置揃え・セル結合・改行・便利ツールまで徹底解説

Markdown(マークダウン)で技術仕様書、README、議事録、ブログ記事、業務マニュアルを作成する際、複雑なデータや比較情報をすっきりと整理して伝えるために欠かせないのが「Markdown 表(テーブル記法 / markdown table)」です。

Markdownで表を作る基本の書き方や区切り行(|---|)のルールをすぐに知りたい」「文字の左揃え・中央揃え・右揃え(アライメント)はどう指定する?」「Markdownの表でセル結合(行結合・列結合)を行うにはどうすればいい?」「セル内での改行(<br>)やチェックボックス、コードの埋め込み方は?」「Excelやスプレッドシートから一瞬でMarkdown表に変換できる便利ツールやVS Code拡張機能を知りたい」といった疑問や悩みを抱えている方は多いのではないでしょうか。

Markdownのテーブル記法は、パイプ(|)とハイフン(-)を組み合わせるシンプルな構文で構成されています。基本ルールと配置指定、さらにHTMLタグを併用したセル結合やセル内改行の応用テクニックを押さえることで、誰でも直感的かつ美しく整ったプロ品質の表を瞬時に作成できるようになります。

この記事では、コピペですぐに使える「Markdown表 逆引きチートシート」をはじめ、基本構文のルール、文字配置(アライメント)の指定法、セルの結合テクニック(colspan / rowspan)、セル内改行・装飾・特殊文字エスケープの実践技、おすすめ作成ツール・VS Code拡張機能、表が崩れる原因と対処法まで、網羅的かつ分かりやすく徹底解説します!

📌 本記事のポイント・要点まとめ

  • 基本構文: ヘッダー行、区切り行(|---|---|)、データ行の3段構成。区切り行は必須
  • 文字揃え(配置): 区切り行にコロン(:)を配置(左揃え :--- / 中央揃え :---: / 右揃え ---:
  • セル結合(結合技): Markdown単体では非対応。HTMLの <td colspan="2">(列結合)や <td rowspan="2">(行結合)を活用する
  • セル内改行: 通常の改行(Enter)は構文が壊れるため、HTMLの <br> タグを使用する
  • パイプ記号の表示: 表の中で文字として | を使う場合は \| または &#124; でエスケープする
  • 効率化ツール: Excelからのコピペ変換ツールやVS Code拡張機能「Markdown Table Prettifier」で爆速作成

【早見表】Markdown表・テーブル 逆引きチートシート

まずは、日常の執筆やドキュメント作成で頻出するMarkdownテーブルの書き方を一覧表にまとめました。コードをそのままコピー&ペーストしてご活用ください。

やりたいこと Markdown記述(コピペ用) ブラウザでの表示結果 主な用途
標準の表
(基本形)
| 項目 | 説明 |
| --- | --- |
| データ1 | データ2 |
ヘッダーとデータのシンプルな2列表 基本データ一覧
左揃え
(デフォルト)
| :--- | :--- |
| 左寄せ | テキスト |
文字が左端に揃う テキスト・名称
中央揃え
(センタリング)
| :---: | :---: |
| 中央 | 状態 |
文字が中央に揃う 日付・ステータス
右揃え
(数値向け)
| ---: | ---: |
| 1,280円 | 95% |
文字が右端に揃う 価格・数量・割合
セル内改行 | 項目 | 1行目<br>2行目 | セル内で複数行に改行表示 箇条書き・詳細説明
セル内装飾
(太字・コード等)
| **太字** | `code` | [リンク](URL) | 太字 / code / リンク 強調・URL埋め込み
チェックボックス
(タスク表)
| - [ ] 未完了 | - [x] 完了 | ☐ 未完了 / ☑ 完了 ToDo・進捗管理
パイプ記号の表示
(エスケープ)
| 条件 | A \|\| B | または | &#124; | セル内に | をそのまま表示 論理演算子・正規表現
列のセル結合
(横結合)
<td colspan="2">2列結合</td> 横に隣り合うセルを合体 カテゴリ統合ヘッダー
行のセル結合
(縦結合)
<td rowspan="2">2行結合</td> 縦に隣り合うセルを合体 グループ分け・共通項目

※Markdown記法全般の早見表や総合チートシートを確認したい方は、サイト内の「【コピペで使える】Markdown記法一覧・チートシート」や「Markdown文法ガイド初心者向け解説」もあわせてご活用ください。

基本の表(テーブル)の書き方:パイプ(|)とハイフン(-)の構文ルール

Markdown 表(マークダウン 表 / markdown table)を作成するための最も基本的な構文ルールを解説します。Markdownの表は、列を区切るパイプ(|と、ヘッダーとデータ行を区切るハイフン(-で構成されます。

1. 表の基本構造(ヘッダー行・区切り行・データ行)

Markdownの表は、必ず以下の3つの要素で成り立っています。

  1. 1行目(ヘッダー行): 各列の項目名(見出し)をパイプ | で区切って記述
  2. 2行目(区切り行 / デリミタ行): ハイフン --- を使ってヘッダーとデータの境目を定義(必須
  3. 3行目以降(データ行): 表の実際のデータ内容をパイプ | で区切って記述
| 商品名 | カテゴリ | 価格 | 在庫状況 |
| --- | --- | --- | --- |
| ノートパソコン | 家電・PC | 128,000円 | 在庫あり |
| ワイヤレスマウス | PC周辺機器 | 3,480円 | 在庫あり |
| 4Kモニター | ディスプレイ | 45,000円 | 入荷待ち |

▼ ブラウザでの表示結果

商品名 カテゴリ 価格 在庫状況
ノートパソコン 家電・PC 128,000円 在庫あり
ワイヤレスマウス PC周辺機器 3,480円 在庫あり
4Kモニター ディスプレイ 45,000円 入荷待ち

2. 両端のパイプ(|)は省略可能?記述が推奨される理由

Markdownの仕様(GFM: GitHub Flavored Markdown等)では、行頭と行末のパイプ | を省略して書くことも認められています。

# 両端のパイプを省略した書き方(動作はしますが非推奨)
商品名 | カテゴリ | 価格
--- | --- | ---
ノートパソコン | 家電・PC | 128,000円
ワイヤレスマウス | PC周辺機器 | 3,480円

💡 両端のパイプ | を必ず書くべき理由:

  • パーサーの互換性向上: 一部のMarkdownエディタや古いレンダラーでは、両端のパイプがないと通常のテキストとして誤認識される恐れがある
  • ソースコードの視認性: プレーンテキストの段階で「ここからここまでが表である」と一目で判別できる
  • フォーマッターツールの誤作動防止: VS CodeやPrettierなどの自動整形ツールが正しくテーブルを認識して整形できる

3. ソースコード内のスペースと列揃え(整形ルール)

Markdownパーサーは、セルの前後に含まれる半角スペースを自動でトリム(無視)してレンダリングします。そのため、ソースコード上で列の幅が不揃いであっても、ブラウザ上では綺麗な表として表示されます。

# スペースを詰め合わせたコンパクトな書き方(ブラウザでの表示結果は同じ)
|商品名|カテゴリ|価格|
|---|---|---|
|ノートパソコン|家電・PC|128,000円|
|ワイヤレスマウス|PC周辺機器|3,480円|

# スペースを入れてコード上の列幅を揃えた書き方(可読性が高くおすすめ!)
| 商品名           | カテゴリ    | 価格      |
| ---------------- | ----------- | --------- |
| ノートパソコン   | 家電・PC    | 128,000円 |
| ワイヤレスマウス | PC周辺機器  | 3,480円   |

コードの保守性やレビュー時の読みやすさを考慮すると、スペースを使ってテキスト上で列幅を揃えて記述するのが圧倒的におすすめです。手動で揃えるのは大変ですが、後述するVS Code拡張機能を使えばワンキーで一瞬で自動整形できます。

文字の配置・アライメント調整(左揃え・中央揃え・右揃え)

表を作成する際、データの種類に応じて「文字を左に寄せたい」「数値を右揃えにしたい」「日付や状態を中央揃えにしたい」という場面が必ずあります。Markdownでは、2行目の区切り行(デリミタ行)に半角コロン(:)を挿入するだけで、列ごとに配置(アライメント)を自由自在にコントロールできます。

1. コロン(:)の位置による3つのアライメント指定構文

配置の種類 区切り行の書き方 おすすめの適用データ
左揃え(左寄せ) :--- または --- 商品名、氏名、概要、説明文、一般的な日本語テキスト
中央揃え(センタリング) :---: 日付、ステータス(完了/未完了)、コード番号、ID、アイコン
右揃え(右寄せ) ---: 金額、個数、割合(%)、ファイルサイズ、スコア等の数値データ

⚠️ ハイフンの個数について:
区切り行のハイフンは最低 1個(例: :---: ではなく :-: でも可)あれば動作しますが、視認性を高めるために 3個以上(:---: で統一して書くのが現代の標準スタイルです。

2. アライメント指定の実践サンプルコードと表示結果

左揃え・中央揃え・右揃えを組み合わせた具体的な売上レポート表の記述例です。

| 項目名(左揃え) | 取引日付(中央揃え) | 注文状態(中央揃え) | 単価(右揃え) | 数量(右揃え) | 小計(右揃え) |
| :--- | :---: | :---: | ---: | ---: | ---: |
| フルHD液晶モニター | 2026-08-20 | 発送済み | 24,800円 | 2 | 49,600円 |
| エルゴノミクスマウス | 2026-08-21 | 決済完了 | 6,500円 | 1 | 6,500円 |
| メカニカルキーボード | 2026-08-22 | 準備中 | 15,200円 | 3 | 45,600円 |
| 合計金額 | - | - | - | 6 | 101,700円 |

▼ ブラウザでの表示結果(数値が綺麗に右揃えされ、桁が揃います)

項目名(左揃え) 取引日付(中央揃え) 注文状態(中央揃え) 単価(右揃え) 数量(右揃え) 小計(右揃え)
フルHD液晶モニター 2026-08-20 発送済み 24,800円 2 49,600円
エルゴノミクスマウス 2026-08-21 決済完了 6,500円 1 6,500円
メカニカルキーボード 2026-08-22 準備中 15,200円 3 45,600円
合計金額 6 101,700円

セルの結合テクニック(行結合・列結合の完全攻略):markdown 表 結合

多くの人が直面する大きな悩みが「Markdownの表でセルを結合したい(行結合・列結合)」という問題です。

💡 Markdown単体ではセル結合記法が存在しない理由:

標準のMarkdown(CommonMark)およびGitHub Flavored Markdown(GFM)には、セル結合専用のMarkdown構文(記号)は定義されていません。テキストベースのシンプルな構造を維持するため、2次元のセル跨ぎを表現する記法が標準仕様から除外されているためです。

しかし諦める必要はありません!Markdownは「HTMLタグをそのまま記述できる」という強力な仕様を持っています。テーブル部分にHTMLの <table> タグを組み合わせることで、横方向の結合(colspan)も縦方向の結合(rowspan)も100%自由に実現できます。

1. 横方向のセル結合(列結合:colspan)の書き方

横に並んだ複数のセルを結合して1つにまとめるには、<th> または <td> タグに colspan="結合する列数" を指定します。

<table>
  <thead>
    <tr>
      <th rowspan="2">プラン名</th>
      <th colspan="2">料金プラン(横に2列結合)</th>
      <th rowspan="2">サポート</th>
    </tr>
    <tr>
      <th>月払い</th>
      <th>年払い(お得)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>スタンダード</td>
      <td>980円 / 月</td>
      <td>9,800円 / 年</td>
      <td>メール</td>
    </tr>
    <tr>
      <td>プレミアム</td>
      <td colspan="2">一括問い合わせ(横に2列結合)</td>
      <td>24時間電話</td>
    </tr>
  </tbody>
</table>

▼ ブラウザでの表示結果(colspanで横セルが綺麗に合体)

プラン名 料金プラン(横に2列結合) サポート
月払い 年払い(お得)
スタンダード 980円 / 月 9,800円 / 年 メール
プレミアム 一括問い合わせ(横に2列結合) 24時間電話

2. 縦方向のセル結合(行結合:rowspan)の書き方

縦に並んだ複数行のセルを結合するには、<td> または <th> タグに rowspan="結合する行数" を指定します。結合された下の行では、その列の <td> タグを省略するのがポイントです。

<table>
  <thead>
    <tr>
      <th>大カテゴリ</th>
      <th>小カテゴリ</th>
      <th>対応ツール例</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td rowspan="3">テキストエディタ(縦に3行結合)</td>
      <td>汎用コードエディタ</td>
      <td>VS Code, Cursor</td>
    </tr>
    <tr>
      <!-- 1列目はrowspanで結合されているため記述不要 -->
      <td>Markdown専用エディタ</td>
      <td>Typora, MarkText</td>
    </tr>
    <tr>
      <!-- 1列目は記述不要 -->
      <td>ナレッジベース・ノート</td>
      <td>Obsidian, Notion</td>
    </tr>
    <tr>
      <td rowspan="2">ドキュメント管理(縦に2行結合)</td>
      <td>社内Wikiツール</td>
      <td>NotePM, GROWI, Kibela</td>
    </tr>
    <tr>
      <td>ソースコードホスティング</td>
      <td>GitHub, GitLab</td>
    </tr>
  </tbody>
</table>

▼ ブラウザでの表示結果(rowspanで縦セルが綺麗に合体)

大カテゴリ 小カテゴリ 対応ツール例
テキストエディタ(縦に3行結合) 汎用コードエディタ VS Code, Cursor
Markdown専用エディタ Typora, MarkText
ナレッジベース・ノート Obsidian, Notion
ドキュメント管理(縦に2行結合) 社内Wikiツール NotePM, GROWI, Kibela
ソースコードホスティング GitHub, GitLab

※Markdown文書内でHTMLタグを活用した高度なレイアウト技法については、「MarkdownとHTMLを併用するプロのテクニック集」でも詳しく解説しています。

【実践・応用技】表(セル内)での高度な表現テクニック

実際の業務ドキュメントやマニュアル作成では、セルの中に「改行を入れたい」「太字やリンクを埋め込みたい」「チェックボックスを並べたい」「パイプ記号(|)そのものを文字として表示したい」といった要求が発生します。それぞれの実践テクニックを詳しく解説します。

1. セル内で改行する方法(<br> タグの活用)

Markdownの表セル内で通常の改行(Enterキー)を押すと、行が分断されて表の構文が完全に崩れてしまいます。セル内で改行を行うには、HTMLの <br> タグ を使用します。

| プラン名 | 特徴・含まれるサービス | 月額料金 |
| :--- | :--- | ---: |
| スターター | ・初期費用無料<br>・ストレージ 10GB<br>・ユーザー数 3名まで | 980円 |
| ビジネス | ・初期費用 10,000円<br>・ストレージ 1TB<br>・ユーザー数 無制限<br>・24時間サポート付き | 4,980円 |

▼ ブラウザでの表示結果(セル内で綺麗に複数行表示されます)

プラン名 特徴・含まれるサービス 月額料金
スターター ・初期費用無料
・ストレージ 10GB
・ユーザー数 3名まで
980円
ビジネス ・初期費用 10,000円
・ストレージ 1TB
・ユーザー数 無制限
・24時間サポート付き
4,980円

※Markdown全般における改行と段落の使い分けについては、「【即解決】Markdownで改行・段落を使い分ける方法」をご覧ください。

2. セル内で太字・斜体・コード・リンク・画像を使う

Markdownのインライン装飾記法は、表のセル内でもそのまま使用できます。

| 装飾の種類 | 記述例(セル内) | 表示結果 |
| :--- | :--- | :--- |
| **太字(強調)** | `**重要な注意事項**` | **重要な注意事項** |
| *斜体(イタリック)* | `*補足コメント*` | *補足コメント* |
| ~~取り消し線~~ | `~~旧定価 5,000円~~ 3,500円` | ~~旧定価 5,000円~~ 3,500円 |
| `インラインコード` | `設定ファイルは `config.json` です` | 設定ファイルは config.json です |
| [リンク埋め込み] | `[公式サイトはこちら](https://example.com)` | 公式サイトへのリンク |
| 画像の埋め込み | `![アイコン](https://example.com/icon.png)` | セル内に画像を表示 |

※太字や取り消し線、マーカーなどの詳しい書き方は「Markdownテキスト装飾一覧ガイド」や「Markdownリンクの書き方完全ガイド」をご確認ください。

3. 表内にチェックボックス(タスク・進捗管理)を配置する

GitHubやQiita、Notion等で機能要件やタスクの進捗状況を一覧管理したい場合、表の中にチェックボックスを埋め込むことができます。

| タスク名 | 担当者 | 状態(チェックボックス) | 期限 |
| :--- | :---: | :---: | :---: |
| 要件定義書の作成 | 田中 | - [x] 完了 | 2026-08-15 |
| DBスキーマ設計 | 佐藤 | - [x] 完了 | 2026-08-18 |
| フロントエンド実装 | 鈴木 | - [ ] 未完了 | 2026-08-25 |
| 単体テスト・結合テスト | 高橋 | - [ ] 未完了 | 2026-08-30 |

※チェックボックスのより詳細な仕様やクリック可能にする設定は「Markdownチェックボックスの書き方完全ガイド」で解説しています。

4. パイプ記号(|)そのものをセル内に表示するエスケープ法

正規表現(a|b)やプログラミングの論理OR演算子(||)、パイプコマンド等をセル内に書きたい場合、そのまま | を入力するとセルの区切り記号と誤認されて表が崩壊してしまいます。

📋 パイプ記号 | をセル内に安全に表示する2つの方法:

  • 方法1(推奨):バックスラッシュでエスケープする(\|
    最も標準的なエスケープ方法です。例: 条件A \|\| 条件B
  • 方法2:HTML特殊文字実体参照を使う(&#124;
    バッククォート(コードブロック内)などでエスケープが効かない場合でも確実に表示されます。
# 正しいエスケープの記述例
| 演算子 | 意味 | 使用例 |
| :--- | :--- | :--- |
| `\|` (ビットOR) | ビット論理和 | `flags \| 0x01` |
| `\|\|` (論理OR) | 条件論理和 | `if (a \|\| b)` |
| `&#124;` (HTMLエンティティ) | パイプ記号 | `grep "foo" &#124; wc -l` |

※特殊記号のエスケープに関する総合解説は「Markdown特殊文字が表示されない原因とエスケープ手順」をご覧ください。

テーブル作成を爆速化する便利ツール&エディタ拡張機能

Markdownの表を手動で |- を打ち込んで作成するのは、列数や行数が増えるほど大きな負担になります。ここでは、表作成を10倍以上スピードアップできるおすすめWebツールやVS Code拡張機能を紹介します。

1. オンラインMarkdownテーブルジェネレーター(Webツール)

ブラウザ上でGUI操作(Excel感覚)で表を作成し、ワンクリックでMarkdown形式のコードを生成できる無料Webサービスです。

  • Tables Generator (tablesgenerator.com)
    最も有名で定番のテーブルジェネレーター。セル幅の変更、アライメント指定、CSVやExcelデータのインポート機能が充実しており、生成されたMarkdownコードを1クリックでコピーできます。
  • TableConvert (tableconvert.com)
    Excel、CSV、JSON、HTML、Markdownを相互に双方向変換できる超多機能ツール。スプレッドシートのデータを貼り付けるだけで、即座に整形済みMarkdown表に変換されます。

2. VS Codeのおすすめ拡張機能(エディタ連携)

VS CodeでMarkdownを書く場合、拡張機能を導入することで表の入力・整形・編集効率が劇的に向上します。

拡張機能名 主な機能・特徴 おすすめポイント
Markdown Table Prettifier バラバラになった表の列幅・パイプ・スペースを自動で美しく揃える ショートカットキーや保存時自動フォーマットに対応
Markdown All in One テーブルの自動補完、キーボード操作での行・列挿入・移動 Markdown執筆の総合神プラグイン
Excel to Markdown table ExcelやGoogleスプレッドシートでコピーした表をMarkdown形式で貼り付け 既存の業務シートを1秒でMarkdown化できる

※VS CodeのMarkdown環境構築やその他のおすすめ拡張機能については、「Visual Studio CodeでMarkdownを効率化する設定ガイド」や「VSCodeプレビュー機能と便利プラグイン活用法」で詳しく解説しています。

3. 専用エディタ(Typora, Obsidian, Notion)での表操作

近年のMarkdown対応ノートアプリや専用エディタでは、GUIによる直感的なテーブル操作が標準搭載されています。

  • Typora 右クリックメニューから行・列の追加・削除・ドラッグ並び替えが可能。見たまま編集できるWYSIWYGの最高峰。
  • Obsidian: ライブプレビューモードで表の列幅リサイズや行の追加ボタンが直感的に操作可能。
  • Notion シンプルテーブルブロックで自由に表を作成し、Markdown形式でエクスポート可能。

Markdown表が崩れる・表示されない原因とトラブルシューティング

「表を書いたのにテキストとしてそのまま表示されてしまう」「列がずれてレイアウトが崩れる」というトラブルの90%以上は、以下の典型的な原因によるものです。該当する項目がないかチェックしてみましょう。

原因1:表の直前に「空行(改行)」がない(最頻出!)

文章の直後に空行を空けずにそのまま表を書き始めると、Markdownパーサーは直前の段落の続きと認識してしまい、テーブルとしてレンダリングされません。

# ❌ NG例:文章の直後に表を連結(崩れる原因)
以下の表をご確認ください。
| 項目 | 値 |
| --- | --- |
| A | 100 |

# ⭕ OK例:必ず直前に「空行(改行)」を1行挟む
以下の表をご確認ください。

| 項目 | 値 |
| --- | --- |
| A | 100 |

原因2:区切り行(|---|---|)が抜けている、またはハイフン不足

Markdownの仕様上、2行目の区切り行(|---|)が存在しない場合、表として認識されません。各列に最低1個以上の半角ハイフン(-)が入っていることを確認してください。

原因3:セル内のパイプ(|)がエスケープされていない

セル内の文字列に |(論理ORや区切り文字)が含まれていると、列数が余分に増えてしまい、以降のすべてのセルが横にずれて表示崩れを引き起こします。必ず \| または &#124; でエスケープしましょう。

原因4:全角パイプ()や全角ハイフン()が混ざっている

日本語入力モードのまま (全角縦線)や (長音符/全角ハイフン)、全角スペースを入力してしまうと、Markdown構文として一切認識されません。構文記号はすべて半角英数文字で入力しましょう。

原因5:セル内でEnterキーによる物理改行を行っている

セル内で改行したいときにEnterキーを押すと、別の行(新しいレコード)として扱われてしまいます。セル内改行には必ず <br> タグを使用してください。

※表崩れのより詳しい原因分析と安定化テクニックは「Markdown表が崩れる原因と対策:テーブルレイアウトを安定させる5つのコツ」もあわせてご覧ください。

よくある質問(FAQ)

Q1. セルの結合はMarkdownの記号だけで書くことは絶対にできませんか?

A. 標準仕様(CommonMark / GFM)ではMarkdown記号単体でのセル結合はできません。 ただし、MarkdownパーサーはHTMLタグをそのまま透過して処理するため、本記事で紹介したように <td colspan="2"><td rowspan="2"> といったHTMLテーブルタグを埋め込むことで、どのプラットフォームでも確実にセル結合を実現できます。

Q2. 表の列幅(幅%やpx指定)を固定・調整することはできますか?

A. 標準のMarkdown構文には幅を指定するパラメータはありません。列幅を細かくコントロールしたい場合は、HTMLの <th style="width:30%;"> のようにインラインCSSスタイルを適用するか、Webサイト側のCSSでテーブルスタイルを調整するのが確実です。

Q3. セルの中で複数行のコードブロック(“`)を書くことはできますか?

A. セル内で ```(フェンスドコードブロック)を直接書くことはできません。セル内でコードを表現する場合は、インラインコード記法(`code`)を使うか、HTMLの <pre><code>...</code></pre> タグをセル内に記述します。

Q4. ExcelやGoogleスプレッドシートの表をそのまま貼り付けることはできますか?

A. VS Code拡張機能「Excel to Markdown table」を導入している場合や、Typora / Notion等のエディタを使用している場合は、Excelでコピーしたセル範囲をそのまま貼り付けるだけで自動的にMarkdown表に変換されます。Webツールの「TableConvert」に貼り付けて変換する方法も非常に簡単です。

Q5. スマホなどの狭い画面で表が横スクロールできるようにするにはどうすればいいですか?

A. 表全体を <div style="overflow-x: auto;">...</div> で囲むことで、スマートフォンの画面幅を超えた場合に指で左右にスワイプ(横スクロール)できるレスポンシブ対応の表になります。

まとめ|Markdown表(テーブル)をマスターして読みやすい文書を作ろう

Markdownの表・テーブル記法は、一見すると記号が多く複雑に見えますが、「ヘッダー + 区切り行(|---|) + データ」という基本構造と、コロン(:)による配置指定さえ押さえれば、驚くほどスピーディーに綺麗なドキュメントを作成できます。

🎯 Markdown表作成のチェックリスト:

  • ✅ 表の直前に空行(改行)を必ず空けているか?
  • ✅ 2行目に必須の区切り行(|---|---|を記述しているか?
  • ✅ 数値列は ---: で右揃え、状態・日付は :---: で中央揃えに設定しているか?
  • ✅ セル内改行は <br> タグで行い、パイプ記号は \| でエスケープしているか?
  • ✅ セル結合(colspan / rowspan)が必要な場合はHTMLテーブルタグを活用しているか?
  • ✅ 大規模な表作成には VS Code拡張機能やオンライン変換ツール を活用しているか?

ぜひ本記事のチートシートやスニペットを手元に保存して、日々のREADME作成、技術ブログ執筆、社内Wikiドキュメントの作成に役立ててください!


📚 あわせて読みたいMarkdown関連記事

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です