Markdownの表作成 — 手で | を並べない
画面上で表を編集すると、Markdownの表記を書き出します。列の寄せ方も指定でき、CSVや表計算ソフトからの貼り付けにも対応します。
Markdownの表は、記号を手で並べて作ります。列が3つくらいなら書けますが、列が増えると | の数を数えることになり、1本ずれただけで崩れます。
画面で行と列を編集して、できあがった表記をコピーする。そのほうが速く、崩れません。
表の書き方の決まり
1行目が見出し、2行目が区切り、3行目以降が中身です。区切り行の書き方で列の寄せ方が決まります。:--- が左寄せ、:---: が中央、---: が右寄せです。
列の数は全行で揃える必要があります。足りない行があると、表として認識されずにそのまま文字として出ます。
セルの中に | を入れたいときは \| と書きます。そのまま書くと列の区切りと解釈されます。
寄せ方の目安
| 内容 | 寄せ方 | 理由 |
|---|---|---|
| 文章・名前 | 左 | 読み始めが揃う |
| 数値・金額 | 右 | 桁が揃って比べやすい |
| 記号・短い区分 | 中央 | 列幅に対して見た目が落ち着く |
Markdownの表でできないこと
セルの結合はできません。複雑な表が必要なら、HTMLの表をそのまま書くか、画像として貼るほうが確実です。
セルの中で改行することもできません。長い文章を入れると列が広がって読みにくくなるので、短くまとめるか、表の外に出してください。
貼り付け先によって、対応の度合いが違います。GitHubや多くのブログは表に対応していますが、古い環境では記号のまま表示されます。
よくある質問
表が崩れます。
見出しの次に区切り行があるか、列の数が全行で揃っているかを確認してください。
セルを結合できますか？
Markdownの表ではできません。必要ならHTMLの表を使ってください。
Excelから貼り付けられますか？
貼り付けに対応しています。タブ区切りのデータとして読み取ります。
作った表は保存されますか？
保存されません。書き出した表記をコピーして使ってください。