TechWriter at work blog

Living and writing documentation at Documatt, small team of programmers that write documentation too.

---

Error parsing content block for the “list-table” directive: uniform …-level bullet list expected, but row … does not contain the same number of items as row … (… vs …)

Symptoms

Sphinx build failed with the error similar to:

WARNING: Error parsing content block for the "list-table" directive: uniform two-level bullet list expected, but row 3 does not contain the same number of items as row 1 (3 vs 2).

Reasons

Table created with list-table:: directive, must have the same number of columns (bullet list items) in all rows. The warning above says that row XY has more or less columns (bullet list items) that the rest of the table.

Example

Row 1 and 2 has 2 columns. Row 3 contains 3 columns.

.. list-table::

   * - row 1, column 1
     - row 1, column 2
   * - row 2, column 1
     - row 2, column 2
   * - row 3, column 1
     - row 3, column 2
     - row 3, column 3

Solution

Delete extra column, or add extra column to all rows.

.. list-table::

   * - row 1, column 1
     - row 1, column 2
   * - row 2, column 1
     - row 2, column 2
   * - row 3, column 1
     - row 3, column 2