Markdown テーブルでは HTML テーブルとしてレンダリングする,読みやすい形式で構造化されたデータを表示できます. このガイドでは GFM (GitHub 味付けされた Markdown) テーブル構文Word テーブルを Markdown に変換する方法.
基本表構文
マークダウンの表は3つの部分からなる.
- ヘッダ行 列名
- 分離器行 テーブルの定義するパイプのダッシュ
- データ行 内容
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |
レンダリングは:
| 第1列 | 2 列 | 3 列 |
|---|---|---|
| 列1 列1 | 列1 列2 | 列1 列3 |
| 2行目 1列目 | 2 行 2 列 | 2 行 3 列 |
列の配列
配列を制御するために,分離行にコロンを使用します.
| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |
| 左に並んでいる | 中央に並べた | 右に並んでいる |
|---|---|---|
| text | text | text |
| 長いテキスト | 長いテキスト | 長いテキスト |
:---左の並行 (デフォルト):---:中央を調整する---:右に並べ
テーブルセル内のフォーマット
ほとんどのインライン Markdown フォーマットは,テーブルセル内で動作します.
| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |
ブロックレベル要素です. ブロックレベル要素は,
細胞内のパイプ文字
文字通りパイプが必要なら | 細胞の中にいるなら 逆のスラッシュで逃げる
| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |
距離 が ない テーブル
パイプの周りの距離はオプションです これは有効です
|Column 1|Column 2|
|---|---|
|Cell|Cell|
しかし一貫した距離は テーブルをより読みやすいものにします ほとんどの編集者やリントは,間隔フォーマットを好む.
空のセル
空のセルにパイプ間のスペースを空にしておく.
| A | B | C |
|---|---|---|
| content | | content |
| | content | |
Word テーブルを Markdown に変換する
Word テーブルが自動的に変換される WordToMD. The converter handles:
- 標準格子 → GFMパイプテーブル
- 列の幅 → 標準化 (Markdownは列の幅を制御していない)
- セル内のテキストフォーマット → 保存 (大文字,斜体,リンク)
変換しないもの
- 結合細胞 (コルスペン/ロースペン) 最寄りの細胞に崩壊
- 多行セル内容 行断線を抜く
- のテーブル 内側のテーブルが平らな
複雑な Word 表の処理
合併した細胞
Wordの結合細胞には Markdownの等価はありません 選択肢:
- 再構築 統合された行を別々の表に分割する
- HTML を使用する ほとんどの Markdown プロセッサは HTML テーブル構文を受け入れる:
<table>
<tr>
<th colspan="2">Merged Header</th>
</tr>
<tr>
<td>Cell 1</td>
<td>Cell 2</td>
</tr>
</table>
複数の行のセル内容
使用する <br> セル内のラインブレイク (GitHubおよびほとんどのプラットフォームで動作) に対して:
| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |
大きい テーブル
列が多いテーブルでは,テーブルが正しいフォーマットであるかどうかを考慮してください. 代替手段
- 定義リスト (用語 + 記述)
- カテゴリー別の複数の小さな表
- 構造化されたデータのコードブロック (JSON,YAML)
プラットフォームによる表表示
| プラットフォーム | GFM 表 | 調整 | HTML 表 |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ |
| GitLab (ギットラボ) | ✅ | ✅ | ✅ |
| Notion | ✅ | ❌ | ❌ |
| Obsidian | ✅ | ✅ | ✅ |
| GitBook | ✅ | ✅ | ✅ |
| VS コードプレビュー | ✅ | ✅ | ✅ |
| Confluence (Markdownマクロ) | ✅ | ✅ | ✅ |
| ジェキル/ヒューゴ/アストロ | ✅ | ✅ | ✅ |
アクセシビリティ
より良いアクセス性を確保するために,表には意味のある列名を持つヘッダー列があるようにしてください. スクリーンリーダーはヘッダ行を使用してセル文脈を表示します.
| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |
レイアウト目的で表を使用しないこと 実際の表データのみ使用する
FAQ
なぜ私の表のレンダリングが 素文字として表示されないのか?
隔離列 ( |---|---| 必須である. それなしでは,解析器はテーブル構造を認識できません.
ヘッダー列のないテーブルを貰えますか?
標準のGFMでは ありません ヘッダ行と分離符が必要である. もし目に見えるヘッダーが不要なら,空のヘッダーを使用してください. | | | 隔離列を付けています
なぜ Word の表は WordToMD に右に見えるが,他の場所に貼った後,間違えるのか? この問題は,通常,セル内の空白や不一致なパイプ文字に 追随するものです. ほとんどの Markdown レンダーは寛容ですが,コピーペーストは見えない文字を導入することができます.
データからテーブルをプログラム的に作成するには?
図書室のような markdown-table (npm) またはPythons tabulate 配列から Markdown テーブルを生成できます これは CSV またはデータベースデータをバッチ変換するのに有用です.
関連ガイド
- マークダウン は 何 です か Markdown 基本
- Markdown 構文 チートシート 完全な文法参照
- Word を Markdown に変換する方法 完全変換ガイド
- DOCX から Markdown までの表 テーブル変換に重点を置く
結論
マークダウンテーブルは構造化されたデータを表示するのに強力で,主要なプラットフォーム全体で広くサポートされています. Word で始まるテーブルでは, WordToMD 自動的に GFM 文法に変換します 複雑なレイアウトでは HTML のバックバックと上記のトリックが必要なコントロールを提供します.