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画像:
→ - 保護(変更しない): コードブロック、数式($$/$...$)、
\*...\*・\[...\]、リンク・画像、:::message・:::details・:::note、<details>・<!-- -->・@[card]等 - 文中の#: 見出し行頭の#のみ半角化、文中の#は維持
対応サービス
以下のサービスで使用されるMarkdown記法に対応しています。他にも多くのサービス(GitHub、GitLab、HackMD、Obsidian など)で利用可能です。
Zenn ▼
対応記法:
- 見出し・リスト・番号リスト・引用・テーブル・脚注・区切り線
- 画像:
幅指定、キャプション*テキスト* - コード:
言語:ファイル名、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. 注意点(ハマりどころ)
- パイプ
|自体をセル内に含めたい場合のエスケープ- セルの中で
|という文字を表示したい場合は\|とバックスラッシュでエスケープしてください。そのまま書くと列区切りとして誤認されます。
- セルの中で