latex-tables

tabularray を使った LaTeX の表

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターが変わった、または回避策が必要になった場合は、先送りせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合にのみ更新してください。

このスキルを使う場面

次の場合にこのスキルを使ってください。

• 固定幅の列を使った表を作成する場合
• 複雑な表のレイアウトを整える場合
• 列を正確に揃える必要がある場合
• tabular/tabularx/longtable/booktabs から移行する場合
• 表がはみ出す問題を解決する場合

クイックリファレンス

tabularray を使う理由

最新の LaTeX3 パッケージ（従来の方法に代わるもの）です。

• 適切に揃えられる固定幅の列
• すっきりと一貫性のある構文
• tabular、tabularx、longtable、booktabs に代わるもの
• 従来のパッケージより優れたパフォーマンス
• TeX Live 2025 に含まれています

---

インストール

# Check if installed
kpsewhich tabularray.sty

# If not found, install:
sudo tlmgr install tabularray

基本的な使い方

\documentclass{article}
\usepackage{tabularray}  % Modern table package

\begin{document}
% Simple table
\begin{tblr}{colspec={ccc}, hlines, vlines}
  Header 1 & Header 2 & Header 3 \\
  Data 1   & Data 2   & Data 3   \\
\end{tblr}
\end{document}

---

クイックリファレンスカード

% Minimal table
\begin{tblr}{colspec={ccc}}
  A & B & C \\
\end{tblr}

% With all lines
\begin{tblr}{colspec={ccc}, hlines, vlines}
  A & B & C \\
\end{tblr}

% Fixed widths
\begin{tblr}{colspec={Q[2cm] Q[3cm] Q[2cm]}, hlines}
  A & B & C \\
\end{tblr}

% Bold header
\begin{tblr}{
  colspec={ccc},
  row{1}={font=\bfseries}
}
  Header & Header & Header \\
  Data   & Data   & Data   \\
\end{tblr}

---

ベストプラクティス

1. 固定幅の列には p{width} ではなく Q[width] を使います
2. テキストがはみ出す可能性がある場合は、幅を明示的に指定します
3. 拡張が必要な柔軟な列には X を使います
4. 手動で書式を設定せず、row{1} でヘッダーをスタイル設定します
5. インラインコマンドではなく、列のプロパティには colspec を使います
6. パッケージのバージョンを確認します：kpsewhich tabularray.sty（新しいバージョンであること）

---

リファレンスドキュメント

詳細については、以下を参照してください。

• 表のパターン - よくある5つの表のパターンと例
• 列の指定 - 配置オプションと幅の制御
• 罫線 - すべての罫線、選択的な罫線、太い罫線
• トラブルシューティング - 表が広すぎる、テキストが折り返されない、配置の問題
• 移行 - tabular および tabularx からの移行

公式ドキュメント：texdoc tabularray を実行すると、パッケージの全ドキュメントを確認できます。

関連項目：

• tabularray パッケージのインストールには latex/setup スキルを使います
• コンパイルのワークフローには latex/build スキルを使います

---

トラブルシューティング

問題	原因	解決策
パッケージが見つからない	tabularray が未インストール	sudo tlmgr install tabularray
表が広すぎる	固定幅の合計がページ幅を超えている	Q[width] の値を小さくするか、柔軟な列には X を使います
テキストが折り返されない	列指定に幅がない	折り返しには c/l/r ではなく Q[width] を使います
配置の問題	列の種類が混在している	すべての列で指定方法に一貫性があることを確認します
colspec でコンパイルエラー	構文が無効	列指定にカンマの不足やタイプミスがないか確認します
hlines が表示されない	指定に含まれていない	指定に hlines を追加します：{colspec={...}, hlines}
行のスタイルが適用されない	行インデックスが間違っている	row{1} は最初の行であることを確認します（1始まり）
パッケージのバージョンが古すぎる	TeX Live が古い	sudo tlmgr update --self --all

実行後の振り返り

このスキルの実行後、終了前に確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラー表を修正します。
2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーター表を更新して一致させます。
3. 回避策が必要でしたか？ — 別のフラグや追加手順など、工夫が必要だった場合は、次回同じ回避策が不要になるように、この SKILL.md を更新します。

推測ではなく、実際に再現できる問題がある場合にのみ更新してください。