markdown tables gfm reference

Markdown テーブル: GFM テーブルシンタクスの完全なガイド

GFM構文,列の並列,複雑なテーブル,レンダリングの特異性, Wordのドキュメントから作成する方法です

W
WordToMD チーム
·

Markdown テーブルでは HTML テーブルとしてレンダリングする,読みやすい形式で構造化されたデータを表示できます. このガイドでは GFM (GitHub 味付けされた Markdown) テーブル構文Word テーブルを Markdown に変換する方法.

基本表構文

マークダウンの表は3つの部分からなる.

  1. ヘッダ行 列名
  2. 分離器行 テーブルの定義するパイプのダッシュ
  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 |
左に並んでいる中央に並べた右に並んでいる
texttexttext
長いテキスト長いテキスト長いテキスト
  • :--- 左の並行 (デフォルト)
  • :---: 中央を調整する
  • ---: 右に並べ

テーブルセル内のフォーマット

ほとんどのインライン 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の等価はありません 選択肢:

  1. 再構築 統合された行を別々の表に分割する
  2. 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 またはデータベースデータをバッチ変換するのに有用です.

結論

マークダウンテーブルは構造化されたデータを表示するのに強力で,主要なプラットフォーム全体で広くサポートされています. Word で始まるテーブルでは, WordToMD 自動的に GFM 文法に変換します 複雑なレイアウトでは HTML のバックバックと上記のトリックが必要なコントロールを提供します.