The nicematrix package

History¶

The development of the package nicematrix is done in the following GitHub depot:

The successive versions of the file nicematrix.sty provided by TeX Live are also available on the svn server of TeX Live:

https:www.tug.org/svn/texlive/trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty

Changes between version 7.11 and 7.12¶

New key color-of-false for the color of the backgrounds of the rows and columns created by the command \FalseRow and the letter F.

New key empty for the command \Block: all the cells of the block will be considered as empty (that’s meaningful, for example, for the computation of the “empty corners”).

Changes between version 7.10 and 7.11¶

New keys xoffset and yoffset in the key tikz of the command \Block (previously, there was only offset which is now a kind of conjunction of xoffset and yoffset).

New command \FalseRow and letter F (for a “false column”).

Changes between version 7.9 and 7.10¶

A generalisation of the key corners has been added with the values N, S, W and E (north, south, west and east).

Changes between version 7.8 and 7.9¶

New keys default-line and rules/fix-vertex

Changes between version 7.7 and 7.8¶

New key draw-trees-in-col (and keys trees/color, trees/line-width and trees/rounded-corners)

Changes between version 7.6 and 7.7¶

New commands \hdashedline, \cdashedline and the letter ;

New key notes/no-print and new command \NiceTabularNotes

Changes between version 7.5 and 7.6¶

New key create-blocks-in-col

An “additive syntax” has been added for several keys: cell-space-limits, xdots/brace-shift, xdots/shorten, notes/code-before, code-for-first-row, etc.

That means that it’s possible to write, for example : cell-space-limits += 3pt.

Changes between version 7.4 and 7.5¶

New key brace-shift for the commands \Hbrace and \Vbrace.

Changes between version 7.3 and 7.4¶

Negative values are now allowed for the keys hlines and vlines.

Changes between version 7.2 and 7.3¶

Simplification of the code by using the latest version of LaTeX : 2025-06-01

Changes between version 7.1 and 7.2¶

A new key V is available in the columns of type X.

Changes between version 7.0 and 7.1¶

New commands \Hbrace and \Vbrace.

New commands \EmptyColumn and \EmptyRow in the \CodeBefore.

Changes between version 6.29 and 7.0¶

The package nicematrix is now compatible (for the tabulars) with the Tagging Project.

Changes between version 6.28 and 6.29¶

Modification in order to be compatible with the next version of array (v. 2.6g).

Changes between version 6.27 and 6.28¶

Sub-blocks with the character & (when the key ampersand-in-block is in force).

Keys p and j for the command \Block.

PGF nodes i.1, i.2, i.3, etc.

Changes between version 6.26 and 6.27¶

New key light-syntax-expanded.

Changes between version 6.25 and 6.26¶

Special color nocolor.

Changes between version 6.24 and 6.25¶

Correction of several bugs.

An instruction \rowlistcolors in the tabular stops the effect of a previous \rowlistcolors.

Changes between version 6.23 and 6.24¶

New command \TikzEveryCell available in the \CodeAfter and the \CodeBefore to apply the same TikZ instruction to all the cells and blocks of the array.

New key offset in the key tikz of a command \Block.

Changes between version 6.22 and 6.23¶

The specifier “|” in the preambles of the environments has now an optional argument.

Correction of several bugs.

Changes between version 6.21 and 6.22¶

Key opacity for the command \Block.

It’s now possible to put a label on a “continuous dotted line” with the specifier “:”.

Changes between version 6.20a and 6.21¶

Key c for the command \tabularnote.

New commands \rowcolors and \rowlistcolors available in the array itself (previously, there were only two commands \rowcolors and \rowlistcolors available in the \CodeBefore.

Changes between version 6.20 and 6.20a¶

The value of the key name of an environment of nicematrix is expanded (in the TeX sens).

The labels of the tabular notes (created by the command \tabularnote) are now composed in an overlapping position only when the horizontal alignment mode of the column is c or r.

Changes between version 6.19 and 6.20¶

New key xdots/horizontal-labels.

Changes between version 6.18 and 6.19¶

The command \tabularnote now supports an optional argument (between square brackets) to change the symbol of the reference of the note.

Changes between version 6.17 and 6.18¶

New key opacity in the commands to color cells, rows and columns.

New key rounded-corners for a whole tabular.

Changes between version 6.16 and 6.17¶

New PGF/TikZ style nicematrix/cell-node.

New key pgf-node-code

Changes between version 6.15 and 6.16¶

It’s now possible to put any LaTeX extensible delimiter (\lgroup, \langle, etc.) in the preamble of an environment with preamble (such as {NiceArray}) by prefixing them by \left and \right.

New key code for the command \SubMatrix in the \CodeAfter.

Changes between version 6.14 and 6.15¶

New key transparent for the command \Block (with that key, the rules are drawn within the block).

Changes between version 6.13 and 6.14¶

New keys for the command \Block for the vertical position of the content of that block.

Changes between version 6.12 and 6.13¶

New environment {TabularNote} in {NiceTabular} with the same semantic as the key tabularnote (for legibility).

The command \Hline nows accepts options (between square brackets).

Changes between version 6.11 and 6.12¶

New keys caption, short-caption and label in the environment {NiceTabular}.

In {NiceTabular}, a caption specified by the key caption is wrapped to the width of the tabular.

Correction of a bug: it’s now possible to use \OverBrace and \UnderBrace with unicode-math (with XeLaTeX or LuaLaTeX).

Changes between version 6.10 and 6.11¶

New key matrix/columns-type to specify the type of columns of the matrices.

New key ccommand in custom-line and new command \cdottedline.

Changes between version 6.9 and 6.10¶

New keys xdots/shorten-start and xdots/shorten-end.

It’s possible to use \line in the \CodeAfter between two blocks (and not only two cells).

Changes between version 6.8 and 6.9¶

New keys xdots/radius and xdots/inter for customisation of the continuous dotted lines.

New command \ShowCellNames available in the \CodeBefore and in the \CodeAfter.

Changes between version 6.7 and 6.8¶

In the notes of a tabular (with the command \tabularnote), the duplicates are now detected: when several commands \tabularnote are used with the same argument, only one note is created at the end of the tabular (but all the labels are present, of course).

Changes between version 6.6 and 6.7¶

Key color for \OverBrace and \UnderBrace in the \CodeAfter

Key tikz in the key borders of a command \Block

Changes between version 6.5 and 6.6¶

Keys tikz and width in custom-line.

Changes between versions 6.4 and 6.5¶

Key custom-line in \NiceMatrixOptions.

Key respect-arraystretch.

Changes between versions 6.3 and 6.4¶

New commands \UnderBrace and \OverBrace in the \CodeAfter.

Correction of a bug of the key baseline (cf. question 623258 on TeX StackExchange).

Correction of a bug with the columns V of varwidth.

Correction of a bug: the use of \hdottedline and : in the preamble of the array (or another letter specified by letter-for-dotted-lines) was incompatible with the key xdots/line-style.

Changes between versions 6.2 and 6.3¶

Keys nb-rows, rowcolor and bold for the command \RowStyle

Key name for the command \Block.

Support for the columns V of varwidth.

Changes between versions 6.1 and 6.2¶

Better compatibility with the classes revtex4-1 (deprecated) and revtex4-2.

Key vlines-in-sub-matrix.

Changes between versions 6.0 and 6.1¶

Better computation of the widths of the X columns.

Key \color for the command \RowStyle.