@@ -1105,20 +1105,23 @@ Values of this type can be created with the
11051105Fields:
11061106
11071107`caption`
1108−: table caption ([List] of [Inlines])
1108+: table caption ([Caption])
11091109
1110−`aligns`
1111−: column alignments ([List] of [Alignment]s)
1110+`colspecs`
1111+: column specifications, i.e., alignments and widths ([List] of
1112+ [ColSpec]s)
11121113
1113−`widths`
1114−: column widths (number)
1114+`head`
1115+: table head ([TableHead])
11151116
1116−`headers`
1117−: header row ([List] of [table cells](#type-table-cell))
1117+`bodies`
1118+: table bodies ([List] of [TableBody]s)
11181119
1119−`rows`
1120−: table rows ([List] of [List]s of [table
1121− cells](#type-table-cell))
1120+`foot`
1121+: table foot ([TableFoot])
1122+
1123+`attr`
1124+: element attributes ([Attr])
11221125
11231126`tag`, `t`
11241127: the literal `Table` (string)
@@ -1520,6 +1523,41 @@ Fields:
15201523List of key/value pairs. Values can be accessed by using keys as
15211524indices to the list table.
15221525
1526+### Caption {#type-caption}
1527+
1528+The caption of a table, with an optional short caption.
1529+
1530+Fields:
1531+
1532+`long`
1533+: long caption (list of [Blocks])
1534+
1535+`short`
1536+: short caption (list of [Inlines])
1537+
1538+### Cell {#type-cell}
1539+
1540+A table cell.
1541+
1542+Fields:
1543+
1544+`attr`
1545+: cell attributes
1546+
1547+`alignment`
1548+: individual cell alignment ([Alignment]).
1549+
1550+`contents`
1551+: cell contents (list of [Blocks]).
1552+
1553+`col_span`
1554+: number of columns occupied by the cell; the height of the cell
1555+ (integer).
1556+
1557+`row_span`
1558+: number of rows occupied by the cell; the height of the cell
1559+ (integer).
1560+
15231561### Citation {#type-citation}
15241562
15251563Single citation entry
@@ -1550,6 +1588,17 @@ Fields:
15501588`hash`
15511589: hash (integer)
15521590
1591+### ColSpec {#type-colspec}
1592+
1593+Column alignment and width specification for a single table
1594+column.
1595+
1596+This is a pair with the following components:
1597+
1598+1. cell alignment ([Alignment]).
1599+2. table column width, as a fraction of the total table width
1600+ (number).
1601+
15531602### ListAttributes {#type-listattributes}
15541603
15551604List attributes
@@ -1573,6 +1622,50 @@ Fields:
15731622: delimiter of list numbers; one of `DefaultDelim`, `Period`,
15741623 `OneParen`, and `TwoParens` (string)
15751624
1625+### Row {#type-row}
1626+
1627+A table row.
1628+
1629+Tuple fields:
1630+
1631+1. row attributes
1632+2. row cells (list of [Cells])
1633+
1634+### TableBody {#type-tablebody}
1635+
1636+A body of a table, with an intermediate head and the specified
1637+number of row header columns.
1638+
1639+Fields:
1640+
1641+`attr`
1642+: table body attributes ([Attr])
1643+
1644+`row_head_columns`
1645+: number of columns taken up by the row head of each row of a
1646+ [TableBody]. The row body takes up the remaining columns.
1647+
1648+`head`
1649+: intermediate head (list of [Rows])
1650+
1651+### TableFoot {#type-tablefoot}
1652+
1653+The foot of a table.
1654+
1655+This is a pair with the following components:
1656+
1657+1. attributes
1658+2. foot rows ([Rows])
1659+
1660+### TableHead
1661+
1662+The head of a table.
1663+
1664+This is a pair with the following components:
1665+
1666+1. attributes
1667+2. head rows ([Rows])
1668+
15761669## ReaderOptions {#type-readeroptions}
15771670
15781671Pandoc reader options
@@ -1723,8 +1816,11 @@ Usage:
17231816[Attributes]: #type-attributes
17241817[Block]: #type-block
17251818[Blocks]: #type-block
1819+[Caption]: #type-caption
1820+[Cells]: #type-cell
17261821[Citation]: #type-citation
17271822[Citations]: #type-citation
1823+[ColSpec]: #type-colspec
17281824[CommonState]: #type-commonstate
17291825[Image]: #type-image
17301826[Inline]: #type-inline
@@ -1738,6 +1834,10 @@ Usage:
17381834[LogMessage]: #type-logmessage
17391835[Pandoc]: #type-pandoc
17401836[Para]: #type-para
1837+[Rows]: #type-row
1838+[TableBody]: #type-tablebody
1839+[TableFoot]: #type-tablefoot
1840+[TableHead]: #type-tablehead
17411841[Version]: #type-version
17421842[`pandoc.utils.equals`]: #pandoc.utils.equals
17431843
@@ -2044,26 +2144,29 @@ format, and functions to filter and modify a subtree.
20442144
20452145 Returns: [RawBlock](#type-rawblock) object
20462146
2047−[`Table (caption, aligns, widths, headers, rows)`]{#pandoc.table}
2147+[`Table (attr, caption, colspecs, head, bodies, foot)`]{#pandoc.table}
20482148
20492149: Creates a table element.
20502150
20512151 Parameters:
20522152
2153+ `attr`:
2154+ : element attributes
2155+
20532156 `caption`:
2054− : table caption
2157+ : table [caption](#type-caption)
20552158
2056− `aligns`:
2057− : alignments
2159+ `colspecs`:
2160+ : column alignments and widths (list of [ColSpec](#type-colspec)s)
20582161
2059− `widths`:
2060− : column widths
2162+ `head`:
2163+ : [table head](#type-tablehead)
20612164
2062− `headers`:
2063− : header row
2165+ `bodies`:
2166+ : [table bodies](#type-tablebody)
20642167
2065− `rows`:
2066− : table rows
2168+ `foot`:
2169+ : [table foot](#type-tablefoot)
20672170
20682171 Returns: [Table](#type-table) object
20692172