HTMLテーブルからMarkdownパイプテーブルへの変換
HTML <table>要素(<thead>、<tbody>、<tr>、<th>、<td>)をMarkdownパイプテーブル構文に変換する方法を解説。配置、colspanの制限、セル内のフォーマットを含みます。
Lists & Tables
詳細な説明
HTMLテーブルからMarkdownへの変換
HTMLテーブルはMarkdownのパイプテーブル構文(GitHub Flavored Markdownの一部)に変換されます。パイプ(|)文字で列を区切り、ハイフンのセパレータ行でヘッダー境界を定義します。
基本的なテーブル変換
最初の行がヘッダーになり、2番目の行がセパレータ(列あたり少なくとも3つのハイフン)、残りの行がデータになります。
列の配置
HTML text-align スタイルまたは align 属性はセパレータ行の配置インジケータに変換されます:
:---= 左揃え:---:= 中央揃え---:= 右揃え
theadなしのテーブル
<thead> がない場合、最初の行がヘッダーとして扱われます。一部のコンバーターは代わりに空のヘッダー行を作成します。
制限事項
Markdownパイプテーブルは以下をサポートしません:
- colspan / rowspan — 結合されたセルはフラットにする必要あり
- 複数行のセルコンテンツ — セルは単一行のみ
- ネストされたテーブル — Markdown構文では不可能
- キャプション —
<caption>コンテンツは通常テーブルの上の段落として配置
複雑なテーブルの場合、一部のコンバーターは構造を保持するために生のHTML出力にフォールバックします。
ユースケース
テーブル変換は、APIリファレンスページ、比較表、価格テーブル、表形式データを含むドキュメントなど、データ量の多いコンテンツの移行に不可欠です。制限を理解することで、テーブルを簡素化するか生のHTMLを保持するかを判断できます。