Markdown 表(Table)の書き方と GitHub / Notion 互換性ガイド

Markdown GitHub Notion ドキュメント
結論:30秒で崩れない Markdown 表を作る
  • 基本構文: | ヘッダー1 | ヘッダー2 ||---|---|| 値1 | 値2 |
  • セル内改行: <br /> を使う
  • 配置合わせ: |:---| (左寄せ), |:---:| (中央), |---:| (右寄せ)

1. オンライン Markdown 表(Table)生成ツール

入力フォームやプレビュー画面でテーブルデータを編集し、即座に GitHub / Notion 互換の Markdown 表コードを出力します。

📝 この場でMarkdownのプレビューを確認する

入力
整形結果

整形内容

  • 全角→半角: #→#、-→-、0-9→0-9、[]→[]、()→() など
  • 見出し: ##ああ## ああ
  • リスト: -あ- あ1.あ1. あ
  • 引用: >引用> 引用さらに> 引用さらに > 引用
  • リストインデント: 行頭の全角スペースを半角2つに(ネスト認識のため)
  • :::details: :::details とタイトルの間にスペースを追加
  • テーブル: |a|b|| a | b |
  • 脚注: [^1]:内容[^1]: 内容
  • 水平線: *** / ___---
  • Zenn画像: ![](url=250x)![](url =250x)
  • 保護(変更しない): コードブロック、数式($$/$...$)、\*...\*\[...\]、リンク・画像、:::message:::details:::note<details><!-- -->@[card]
  • 文中の#: 見出し行頭の#のみ半角化、文中の#は維持

対応サービス

以下のサービスで使用されるMarkdown記法に対応しています。他にも多くのサービス(GitHub、GitLab、HackMD、Obsidian など)で利用可能です。

Zenn

対応記法:

  • 見出し・リスト・番号リスト・引用・テーブル・脚注・区切り線
  • 画像: ![](url =250x) 幅指定、キャプション *テキスト*
  • コード: 言語:ファイル名diff js
  • 数式: $$ ブロック、$ インライン(KaTeX)
  • 独自: :::message / :::message alert / :::details:::でネスト)
  • 埋め込み: @[card] @[tweet] @[youtube] @[gist] @[codepen]
  • mermaid・絵文字 :emoji:・HTMLコメント <!-- -->
Qiita

対応記法:

  • GFM準拠 + 拡張。コード: 言語:ファイル名diff_言語
  • :::note info / warn / alert
  • <details><summary> 折りたたみ
  • チェックボックス - [ ] - [x]、説明リスト <dl>
  • 数式: ```math または $`...`$
  • PlantUML・Mermaid・絵文字・リンクカード(URL単独行)
  • 参照リンク [text][ref]、ページ内リンク #見出し
note

対応記法:

  • 見出し・引用・箇条書き・番号リスト・強調・コードブロック・取り消し・区切り線
  • 見出しは h2・h3 のみ(h1 は h2 に変換)
  • 強調: ** 推奨(__ は前後にスペース必要)
  • リスト: -* 混在は非推奨
VSCode / GFM

対応記法:

  • 見出し・リスト・番号リスト・引用・リンク・画像・テーブル・水平線
  • コード: 言語:ファイル名(例: c:main.c
  • 斜体 *・太字 **・打ち消し ~~

※ Zenn・Qiita・note・HackMD・GitHub・GFM など各種Markdown記法に対応。


2. GFM (GitHub Flavored Markdown) 表の標準コード

| 項目名 (Header) | データ型 | 説明 |
|:---|:---:|---:|
| `user_id` | **String** | ユーザーの一意識別子 |
| `created_at` | **Timestamp** | アカウント作成日時 (<br />ISO 8601 形式) |

3. 注意点(ハマりどころ)

  1. パイプ | 自体をセル内に含めたい場合のエスケープ
    • セルの中で | という文字を表示したい場合は \| とバックスラッシュでエスケープしてください。そのまま書くと列区切りとして誤認されます。