Markdown の表の書き方
表は Markdown の中でもとくに便利で、同時に間違えやすい記法です。この記事では基本の形から、揃え、改行、特殊記号、表計算ソフトからの変換までまとめます。試しながら読むなら、Markdown オンラインエディタに例を貼り付けるとすぐに結果を確認できます。
基本の書き方
表は見出し行、区切り行、データ行の 3 つでできています。列は | で区切ります。
| 名前 | 部署 | 内線 |
| --- | --- | --- |
| 山田 | 営業部 | 101 |
| 佐藤 | デザイン部 | 205 |
表示結果:
| 名前 | 部署 | 内線 |
|---|---|---|
| 山田 | 営業部 | 101 |
| 佐藤 | デザイン部 | 205 |
ポイント:
- 2 行目の
---は省略できません。各列に-を 3 つ以上書きます。 - 両端の
|は省略できますが、書いておくと読みやすくなります。 - 各行の列数は見出し行と揃えます。
- 表の前後には空行を入れます。
列の揃え
区切り行にコロン : を付けて揃え方を指定します:
| 左揃え | 中央揃え | 右揃え |
| :--- | :---: | ---: |
| りんご | 10 | ¥300 |
| バナナ | 5 | ¥150 |
| 左揃え | 中央揃え | 右揃え |
|---|---|---|
| りんご | 10 | ¥300 |
| バナナ | 5 | ¥150 |
数値や金額は右揃えにすると比べやすくなります。
セルの中にコード・リンク・太字
セルの中でもインラインの記法が使えます:
| コマンド | 説明 |
| --- | --- |
| `npm install` | パッケージをインストール([公式ドキュメント](https://docs.npmjs.com/)) |
| **必須** | この項目は必ず入力 |
セルに「|」を表示したい
パイプは列の区切りとして扱われるので、前にバックスラッシュを付けます:
| 演算子 | 意味 |
| --- | --- |
| `a \| b` | ビット単位の OR |
セル内で改行したい
標準の Markdown の表は、セル内の改行に対応していません。各行は 1 行で書く必要があります。よくある対処法:
- GitHub では
<br>で改行できます(例:1 行目<br>2 行目)。 - Moread は安全のため HTML タグを実行しないので、
<br>はそのまま表示されます。複数の行に分けるか、リストを使ってください。
セルを結合したい
標準の Markdown の表ではセルを結合できません。代わりの方法:
- 同じ内容を繰り返し書いて、表の形を保つ。
- 表を小さな 2 つの表に分ける。
- 内容が複雑なら、リストや小見出しで整理したほうが読みやすいことも多いです。
Excel や Google スプレッドシートから変換する
セルをコピーして貼り付けると、タブ区切りのテキストになります。変換するには:
- テキストエディタでタブを
|に置換し、各行の両端に|を付けて区切り行を入れる。 - または「Excel to Markdown」のような変換ツールを使う。
できたらオンラインエディタに貼り付けて、列が揃っているか確認しましょう。
横に長い表
列の多い表はスマホでははみ出します。Moread では表を横にスクロールできるので、レイアウトが崩れません。書くときは次の工夫も有効です:
- 重要でない列を削る。
- セルには短いキーワードを書き、詳細は表の下で説明する。
コピー用テンプレート
| 項目 | 数量 | 金額 |
| :--- | ---: | ---: |
| 項目 1 | 1 | 100 |
| 項目 2 | 2 | 250 |
| **合計** | **3** | **350** |
ほかの記法は Markdown の書き方、表をレポートにするなら Markdown を PDF に変換する方法をご覧ください。