LaTeX Tables with tabularray

When to Use This Skill

Use this skill when:

• Creating tables with fixed-width columns

• Formatting complex table layouts

• Need precise column alignment

• Migrating from tabular/tabularx/longtable/booktabs

• Troubleshooting table overflow issues

Quick Reference

Why tabularray?

Modern LaTeX3 package (replaces old solutions):

• Fixed-width columns with proper alignment

• Clean, consistent syntax

• Replaces: tabular , tabularx , longtable , booktabs

• Better performance than legacy packages

• Part of TeX Live 2025

Installation

Check if installed

kpsewhich tabularray.sty

If not found, install:

sudo tlmgr install tabularray

Basic Usage

\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}

Quick Reference Card

% 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}

Best Practices

• Use Q[width] for fixed columns instead of p{width}

• Specify widths explicitly when text might overflow

• Use X for flexible columns that should expand

• Style headers with row{1} instead of manual formatting

• Use colspec for column properties, not inline commands

• Check package version: kpsewhich tabularray.sty (should be recent)

Reference Documentation

For detailed information, see:

• Table Patterns - 5 common table patterns with examples

• Column Specification - Alignment options and width control

• Lines and Borders - All lines, selective lines, thick lines

• Troubleshooting - Table too wide, text not wrapping, alignment issues

• Migration - Migrating from tabular and tabularx

Official Docs: Run texdoc tabularray for complete package documentation

See Also:

• Use latex/setup skill for installing tabularray package

• Use latex/build skill for compilation workflows

Troubleshooting

Issue Cause Solution

Package not found tabularray not installed sudo tlmgr install tabularray

Table too wide Fixed widths exceed page Use smaller Q[width] values or X for flexible

Text not wrapping Column spec missing width Use Q[width] instead of c/l/r for wrapping

Alignment issues Mixed column types Ensure all columns have consistent spec

Compile error on colspec Invalid syntax Check for missing commas or typos in column spec

hlines not appearing Missing from spec Add hlines to the spec: {colspec={...}, hlines}

Row style not applied Wrong row index Remember row{1} is first row (1-indexed)

Package version too old TeX Live outdated sudo tlmgr update --self --all