結論
Markdownの表は、使う変換先によって扱える記法が違います。 単純な2列表をPDFにできても、セル内の縦棒、改行、中央揃えまで同じように再現するとは限りません。当サイトの現行処理でも、数量が表示されなくなる入力を確認しました。
Markdown PDF変換単純な表の見本と出力を比較する登録なしで使えます開く
GitHub Flavored Markdown（GFM）の仕様は、表を一次資料の節に引用したとおり位置付けています。
GFMはMarkdownの拡張であり、GitHubの表の説明をすべての変換ツールへ当てはめることはできません。 以下では、公式記法の説明と当サイトで実際に出力した結果を区別します。
単純な表は見出しと区切り行を分ける
基本になるのは、見出し行・区切り行・データ行です。縦棒で列を区切り、見出しの次の行にハイフンを置くと、文字列の並びと表の構造を分けられます。
markdown
| 品名 | 個数 |
| --- | --- |
| 鉛筆 | 12 |
| 消しゴム | 8 |
GitHubの公式ヘルプは、列を区切る記号について一次資料の節に引用したとおり説明しています。
今回の通常表では、この2列・2データ行が保存したPDFにも表示されました。原稿の行頭・行末を含む記号と、出力の列数・数量を対応させることが確認の基準になります。
自作4条件のPDF出力を比べた
同じ品名と数量を基に、自作の表4条件を現行変換で測りました（n=4）。 2026-10-01、通常表、セル内の縦棒、HTML改行、列の配置指定をそれぞれPDFにしています。
| 条件 | 原稿で変えた点 | 保存したPDFの結果 |
|---|---|---|
| 通常表 | 2列・2データ行 | 鉛筆12、消しゴム8を表示 |
| セル内の縦棒 | 品名に逆斜線付きの縦棒を入れた | 2列表なのにデータを3要素へ分割し、数量12を表示しなかった |
| HTML改行 | 品名を鉛筆と赤の間のHTML改行タグでつないだ | タグの文字をそのまま表示し、セル内改行にはならなかった |
| 列の配置指定 | 区切り行に右揃え・中央揃えのコロンを付けた | 通常表と同じ文字の横位置で、指定を反映しなかった |
縦棒の条件は、品名を 鉛筆\|赤、個数を「12」とした1データ行です。現行処理はその行を 鉛筆\・赤・12 の3要素へ分け、PDFには最初の2要素だけを描いたため、数量が落ちました。 この入力を実務用の変換として採用できる結果ではありません。
配置指定の条件は、区切り行を | ---: | :---: | にしました。通常表と比較した6か所の表文字の横位置は一致していました。HTML改行の条件は <br> が表示上の改行として扱われませんでした。
全4件がA4縦1ページです。保存PDFの画像を別の読取処理で取り出し、描画時の画像と全画素が一致することも確認しました。 全4件の表を目視し、文字描画の記録とも照合しています。生成PDFはページを画像として保存する方式で、今回の文字抽出結果は0文字でした。
セル内の複雑な構造は別の確認が必要
GFMで記せることと、このPDF変換で再現できることを分ける必要があります。 GFMは逆斜線でセル内の縦棒をエスケープする例を載せていますが、今回の現行処理はその例と同じ扱いではありません。
GFMの表の仕様には、次の制約もあります。
複数段落や見出しのようなブロックを、通常のセルへ自由に入れられるという仕様ではありません。 HTMLを併用する別の描画環境の手順を、そのまま当サイトの入力へ移すこともできません。当サイトはHTMLの直接入力やセル結合を行う機能を備えていません。
また、区切り行を欠いた縦棒の行では、現行の解析処理が検証用の制限時間内に戻りませんでした。表の作成途中の入力にも未解決の課題がある状態です。今回は機能を修正せず、出力の比較と問題の記録だけを行っています。
一次資料
本文で参照した一次資料の引用と出典をまとめます。
“GFM enables the table extension”
— GitHub「GitHub Flavored Markdown Spec」、4.10 Tables https://github.github.com/gfm/#tables-extension-（2026-10-01 到達）
「パイプは各列の区切りに使用されます。」
— GitHub Docs「情報を表に編成する」、テーブルの作成 https://docs.github.com/ja/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables（2026-10-01 到達）
“Block-level elements cannot be inserted in a table.”
— GitHub「GitHub Flavored Markdown Spec」、4.10 Tables https://github.github.com/gfm/#tables-extension-（2026-10-01 到達）
測っていないこと・ここから先は推論
GitHub画面の操作、Word（ワード）への往復、長大な表、印刷結果、全記法の互換性は測っていません。 通常表1例の成功は、すべての表の安全な変換を保証しません。セル結合を新しく実装したり、不正な入力の処理を修正したりもしていません。
次の1手
列数、各行の品名と数量、改行、配置を原稿と出力で対応させることが入口です。現行処理の未対応記法や数量が落ちる例があるため、単純な表の見本の結果と複雑な表の再現性を分けて考える必要があります。