lua-filters.md: Partially autogenerate docs for module "pandoc"

The documentation system isn't powerful enough to generate the full
documentation automatically.

1 files changed, 490 insertions, 286 deletions

diff --git a/doc/lua-filters.md b/doc/lua-filters.md
index b90aa01b8..9de10cfbf 100644
--- a/doc/lua-filters.md
+++ b/doc/lua-filters.md
@@ -2410,23 +2410,14 @@ Usage:
       'pandoc-types is too old: expected version %s, got %s'
     )
 
-[Alignment]: #type-alignment
-[Attr]: #type-attr
 [Attributes]: #type-attributes
-[Block]: #type-block
-[Blocks]: #type-blocks
-[Caption]: #type-caption
-[Cell]: #type-cell
 [Cells]: #type-cell
 [Citation]: #type-citation
 [Citations]: #type-citation
 [ColSpec]: #type-colspec
 [CommonState]: #type-commonstate
 [Div]: #type-div
-[Figure]: #type-figure
 [Image]: #type-image
-[Inline]: #type-inline
-[Inlines]: #type-inlines
 [List]: #type-list
 [ListAttributes]: #type-listattributes
 [Meta]: #type-meta
@@ -2437,13 +2428,8 @@ Usage:
 [Pandoc]: #type-pandoc
 [Para]: #type-para
 [Plain]: #type-plain
-[Row]: #type-row
 [Rows]: #type-row
 [SimpleTable]: #type-simpletable
-[Table]: #type-table
-[TableBody]: #type-tablebody
-[TableFoot]: #type-tablefoot
-[TableHead]: #type-tablehead
 [Version]: #type-version
 
 ## Chunk {#type-chunk}
@@ -2509,755 +2495,935 @@ Fields:
 `toc`
 :   table of contents information (table)
 
+<!-- BEGIN: AUTOGENERATED CONTENT for module pandoc -->
+
 # Module pandoc
 
 Fields and functions for pandoc scripts; includes constructors for
-document tree elements, functions to parse text in a given
-format, and functions to filter and modify a subtree.
+document tree elements, functions to parse text in a given format,
+and functions to filter and modify a subtree.
 
-## Static Fields {#pandoc.fields}
+## Fields {#pandoc-fields}
 
 ### readers {#pandoc.readers}
 
 Set of formats that pandoc can parse. All keys in this table can
-be used as the `format` value in `pandoc.read`.
+be used as the `format` value in `pandoc.read`. (table)
 
 ### writers {#pandoc.writers}
 
 Set of formats that pandoc can generate. All keys in this table
-can be used as the `format` value in `pandoc.write`.
+can be used as the `format` value in `pandoc.write`. (table)
 
-## Pandoc
+## Functions {#pandoc-functions}
 
-### `Pandoc (blocks[, meta])` {#pandoc.pandoc}
+### Pandoc {#pandoc.Pandoc}
 
-A complete pandoc document
+`Pandoc (blocks[, meta])`
 
 Parameters:
 
 `blocks`
-:   document content
+:   document contents ([Blocks])
 
 `meta`
-:   document meta data
+:   document metadata ([Meta])
 
-Returns: [Pandoc] object
+Returns:
 
-## Meta
+-   new Pandoc document ([Pandoc])
 
-### `Meta (table)` {#pandoc.meta}
+### Meta {#pandoc.Meta}
 
-Create a new Meta object.
+`Meta (meta)`
 
 Parameters:
 
-`table`
-:   table containing document meta information
+`meta`
+:   table containing meta information (table)
+
+Returns:
 
-Returns: [Meta] object
+-   new Meta table (table)
 
-## MetaValue
+### MetaBlocks {#pandoc.MetaBlocks}
 
-### `MetaBlocks (blocks)` {#pandoc.metablocks}
+`MetaBlocks (content)`
 
-Creates a value to be used as a MetaBlocks value in meta
-data; creates a copy of the input list via `pandoc.Blocks`,
-discarding all non-list keys.
+Creates a value to be used as a MetaBlocks value in meta data;
+creates a copy of the input list via `pandoc.Blocks`, discarding
+all non-list keys.
 
 Parameters:
 
-`blocks`
-:   blocks
+`content`
+:   block content ([Blocks])
+
+Returns:
 
-Returns: [Blocks][]
+-   list of Block elements ([Blocks])
 
-### `MetaInlines (inlines)` {#pandoc.metainlines}
+### MetaBool {#pandoc.MetaBool}
 
-Creates a value to be used as a MetaInlines value in meta
-data; creates a copy of the input list via `pandoc.Inlines`,
-discarding all non-list keys.
+`MetaBool (bool)`
 
 Parameters:
 
-`inlines`
-:   inlines
+`bool`
+:   true or false (boolean)
+
+Returns:
 
-Returns: [Inlines][]
+-   input, unchanged (boolean)
 
-### `MetaList (meta_values)` {#pandoc.metalist}
+### MetaInlines {#pandoc.MetaInlines}
 
-Creates a value to be used as a MetaList in meta data;
-creates a copy of the input list via `pandoc.List`,
-discarding all non-list keys.
+`MetaInlines (inlines)`
+
+Creates a value to be used as a MetaInlines value in meta data;
+creates a copy of the input list via `pandoc.Inlines`, discarding
+all non-list keys.
 
 Parameters:
 
-`meta_values`
-:   list of meta values
+`inlines`
+:   inline elements ([Inlines])
+
+Returns:
+
+-   list of Inline elements ([Inlines])
 
-Returns: [List]
+### MetaList {#pandoc.MetaList}
 
-### `MetaMap (key_value_map)` {#pandoc.metamap}
+`MetaList (values)`
 
-Creates a value to be used as a MetaMap in meta data; creates
-a copy of the input table, keeping only pairs with string
-keys and discards all other keys.
+Creates a value to be used as a MetaList in meta data; creates a
+copy of the input list via `pandoc.List`, discarding all non-list
+keys.
 
 Parameters:
 
-`key_value_map`
-:   a string-indexed map of meta values
+`values`
+:   value, or list of values ([MetaValue]\|{[MetaValue],\...})
+
+Returns:
 
-Returns: table
+-   list of meta values ([List]{unknown-type="List"})
 
-### `MetaString (str)` {#pandoc.metastring}
+### MetaMap {#pandoc.MetaMap}
 
-Creates a value to be used as a MetaString in meta data; this
-is the identity function for boolean values and exists only
-for completeness.
+`MetaMap (key_value_map)`
+
+Creates a value to be used as a MetaMap in meta data; creates a
+copy of the input table, keeping only pairs with string keys and
+discards all other keys.
 
 Parameters:
 
-`str`
-:   string value
+`key_value_map`
+:   a string-indexed map of meta values (table)
 
-Returns: string
+Returns:
 
-### `MetaBool (bool)` {#pandoc.metabool}
+-   map of meta values (table)
 
-Creates a value to be used as MetaBool in meta data; this is
+### MetaString {#pandoc.MetaString}
+
+`MetaString (s)`
+
+Creates a value to be used as a MetaString in meta data; this is
 the identity function for boolean values and exists only for
 completeness.
 
 Parameters:
 
-`bool`
-:   boolean value
+`s`
+:   string value (string)
+
+Returns:
 
-Returns: boolean
+-   unchanged input (string)
 
-## Block
+### BlockQuote {#pandoc.BlockQuote}
 
-### `BlockQuote (content)` {#pandoc.blockquote}
+`BlockQuote (content)`
 
 Creates a block quote element
 
 Parameters:
 
 `content`
-:   block content
+:   block content ([Blocks])
+
+Returns:
+
+-   BlockQuote element ([Block])
 
-Returns: [BlockQuote] object
+### BulletList {#pandoc.BulletList}
 
-### `BulletList (items)` {#pandoc.bulletlist}
+`BulletList (items)`
 
 Creates a bullet list.
 
 Parameters:
 
 `items`
-:   list items
+:   list items ({[Blocks],\...})
+
+Returns:
 
-Returns: [BulletList] object
+-   BulletList element ([Block])
 
-### `CodeBlock (text[, attr])` {#pandoc.codeblock}
+### CodeBlock {#pandoc.CodeBlock}
 
-Creates a code block element
+`CodeBlock (text[, attr])`
+
+Creates a code block element.
 
 Parameters:
 
 `text`
-:   code string
+:   code string (string)
 
 `attr`
-:   element attributes
+:   element attributes ([Attr])
 
-Returns: [CodeBlock] object
+Returns:
 
-### `DefinitionList (content)` {#pandoc.definitionlist}
+-   CodeBlock element ([Block])
 
-Creates a definition list, containing terms and their
-explanation.
+### DefinitionList {#pandoc.DefinitionList}
+
+`DefinitionList (content)`
+
+Creates a definition list, containing terms and their explanation.
 
 Parameters:
 
 `content`
-:   list of items
+:   definition items ([{{Inlines,
+    {Blocks,\...}},\...}]{unknown-type="{{Inlines, {Blocks,...}},...}"})
 
-Returns: [DefinitionList] object
+Returns:
+
+-   DefinitionList element ([Block])
 
-### `Div (content[, attr])` {#pandoc.div}
+### Div {#pandoc.Div}
+
+`Div (content[, attr])`
 
 Creates a div element
 
 Parameters:
 
 `content`
-:   block content
+:   block content ([Blocks])
 
 `attr`
-:   element attributes
+:   element attributes ([Attr])
+
+Returns:
+
+-   Div element ([Block])
 
-Returns: [Div] object
+### Figure {#pandoc.Figure}
 
-### `Figure (content[, caption[, attr]])` {#pandoc.figure}
+`Figure (content[, caption[, attr]])`
 
-Creates a [Figure][] element.
+Creates a [Figure] element.
 
 Parameters:
 
 `content`
-:   figure block content
+:   figure block content ([Blocks])
 
 `caption`
-:   figure caption
+:   figure caption ([Caption])
 
 `attr`
-:   element attributes
+:   element attributes ([Attr])
+
+Returns:
+
+-   Figure object ([Block])
 
-Returns: [Figure][] object
+### Header {#pandoc.Header}
 
-### `Header (level, content[, attr])` {#pandoc.header}
+`Header (level, content[, attr])`
 
 Creates a header element.
 
 Parameters:
 
 `level`
-:   header level
+:   heading level ([integer]{unknown-type="integer"})
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
 `attr`
-:   element attributes
+:   element attributes ([Attr])
+
+Returns:
 
-Returns: [Header] object
+-   Header element ([Block])
 
-### `HorizontalRule ()` {#pandoc.horizontalrule}
+### HorizontalRule {#pandoc.HorizontalRule}
+
+`HorizontalRule ()`
 
 Creates a horizontal rule.
 
-Returns: [HorizontalRule] object
+Returns:
+
+-   HorizontalRule element ([Block])
+
+### LineBlock {#pandoc.LineBlock}
 
-### `LineBlock (content)` {#pandoc.lineblock}
+`LineBlock (content)`
 
 Creates a line block element.
 
 Parameters:
 
 `content`
-:   inline content
+:   lines ({[Inlines],\...})
 
-Returns: [LineBlock] object
+Returns:
+
+-   LineBlock element ([Block])
 
-### `OrderedList (items[, listAttributes])` {#pandoc.orderedlist}
+### OrderedList {#pandoc.OrderedList}
+
+`OrderedList (items[, listAttributes])`
 
 Creates an ordered list.
 
 Parameters:
 
 `items`
-:   list items
+:   list items ({[Blocks],\...})
 
 `listAttributes`
-:   list parameters
+:   list parameters ([ListAttributes])
 
-Returns: [OrderedList](#type-orderedlist) object
+Returns:
+
+-   OrderedList element ([Block])
 
-### `Para (content)` {#pandoc.para}
+### Para {#pandoc.Para}
+
+`Para (content)`
 
 Creates a para element.
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
-Returns: [Para](#type-para) object
+Returns:
 
-### `Plain (content)` {#pandoc.plain}
+-   Para element ([Block])
+
+### Plain {#pandoc.Plain}
+
+`Plain (content)`
 
 Creates a plain element.
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
-Returns: [Plain](#type-plain) object
+Returns:
 
-### `RawBlock (format, text)` {#pandoc.rawblock}
+-   Plain element ([Block])
+
+### RawBlock {#pandoc.RawBlock}
+
+`RawBlock (format, text)`
 
 Creates a raw content block of the specified format.
 
 Parameters:
 
 `format`
-:   format of content
+:   format of content (string)
 
 `text`
-:   string content
+:   raw content (string)
+
+Returns:
+
+-   RawBlock element ([Block])
 
-Returns: [RawBlock](#type-rawblock) object
+### Table {#pandoc.Table}
 
-### `Table (caption, colspecs, head, bodies, foot[, attr])` {#pandoc.table}
+`Table (caption, colspecs, head, bodies, foot[, attr])`
 
 Creates a table element.
 
 Parameters:
 
 `caption`
-:   table [caption](#type-caption)
+:   table caption ([Caption])
 
 `colspecs`
-:   column alignments and widths (list of [ColSpec](#type-colspec)s)
+:   column alignments and widths ({[ColSpec],\...})
 
 `head`
-:   [table head](#type-tablehead)
+:   table head ([TableHead])
 
 `bodies`
-:   [table bodies](#type-tablebody)
+:   table bodies ({[TableBody],\...})
 
 `foot`
-:   [table foot](#type-tablefoot)
+:   table foot ([TableFoot])
 
 `attr`
-:   element attributes
+:   element attributes ([Attr])
 
-Returns: [Table](#type-table) object
+Returns:
+
+-   Table element ([Block])
 
-## Blocks
+### Blocks {#pandoc.Blocks}
 
-### `Blocks (block_like_elements)` {#pandoc.blocks}
+`Blocks (block_like_elements)`
 
-Creates a [Blocks][] list.
+Creates a [Blocks] list.
 
 Parameters:
 
 `block_like_elements`
-:   List where each element can be treated as a [Block]
-    value, or a single such value.
+:   List where each element can be treated as a [Block] value, or
+    a single such value. ([Blocks])
+
+Returns:
 
-Returns: [Blocks][]
+-   list of block elements ([Blocks])
 
-## Inline
+### Cite {#pandoc.Cite}
 
-### `Cite (content, citations)` {#pandoc.cite}
+`Cite (Inlines, citations)`
 
 Creates a Cite inline element
 
 Parameters:
 
-`content`
-:   List of inlines
+`Inlines`
+:   placeholder content ([content]{unknown-type="content"})
 
 `citations`
-:   List of citations
+:   List of Citations ({[Citation]{unknown-type="Citation"},\...})
+
+Returns:
 
-Returns: [Cite](#type-cite) object
+-   cite element ([Inline])
 
-### `Code (text[, attr])` {#pandoc.code}
+### Code {#pandoc.Code}
+
+`Code (code[, attr])`
 
 Creates a Code inline element
 
 Parameters:
 
-`text`
-:   code string
+`code`
+:   code string (string)
 
 `attr`
-:   additional attributes
+:   additional attributes ([Attr])
 
-Returns: [Code](#type-code) object
+Returns:
 
-### `Emph (content)` {#pandoc.emph}
+-   code element ([Inline])
+
+### Emph {#pandoc.Emph}
+
+`Emph (content)`
 
 Creates an inline element representing emphasized text.
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
+
+Returns:
 
-Returns: [Emph](#type-emph) object
+-   new object ([Inline])
 
-### `Image (caption, src[, title[, attr]])` {#pandoc.image}
+### Image {#pandoc.Image}
 
-Creates a Image inline element
+`Image (caption, src[, title[, attr]])`
+
+Creates an Image element
 
 Parameters:
 
 `caption`
-:   text used to describe the image
+:   text used to describe the image ([Inlines])
 
 `src`
-:   path to the image file
+:   path to the image file (string)
 
 `title`
-:   brief image description
+:   brief image description (string)
 
 `attr`
-:   additional attributes
+:   image attributes ([Attr])
 
-Returns: [Image](#type-image) object
+Returns:
+
+-   Image element ([Inline])
 
-### `LineBreak ()` {#pandoc.linebreak}
+### LineBreak {#pandoc.LineBreak}
+
+`LineBreak ()`
 
 Create a LineBreak inline element
 
-Returns: [LineBreak](#type-linebreak) object
+Returns:
 
-### `Link (content, target[, title[, attr]])` {#pandoc.link}
+-   line break ([Inline])
+
+### Link {#pandoc.Link}
+
+`Link (content, target[, title[, attr]])`
 
 Creates a link inline element, usually a hyperlink.
 
 Parameters:
 
 `content`
-:   text for this link
+:   text for this link ([Inlines])
 
 `target`
-:   the link target
+:   the link target (string)
 
 `title`
-:   brief link description
+:   brief link description (string)
 
 `attr`
-:   additional attributes
+:   link attributes ([Attr])
+
+Returns:
+
+-   link element ([Inline])
 
-Returns: [Link](#type-link) object
+### Math {#pandoc.Math}
 
-### `Math (mathtype, text)` {#pandoc.math}
+`Math (mathtype, text)`
 
 Creates a Math element, either inline or displayed.
 
 Parameters:
 
 `mathtype`
-:   rendering specifier
+:   rendering specifier ([MathType]{unknown-type="MathType"})
 
 `text`
-:   Math content
+:   math content (string)
+
+Returns:
 
-Returns: [Math](#type-math) object
+-   math element ([Inline])
 
-### `Note (content)` {#pandoc.note}
+### Note {#pandoc.Note}
+
+`Note (content)`
 
 Creates a Note inline element
 
 Parameters:
 
 `content`
-:   footnote block content
+:   footnote block content ([Blocks])
+
+Returns:
+
+-   note ([Inline])
 
-Returns: [Note](#type-note) object
+### Quoted {#pandoc.Quoted}
 
-### `Quoted (quotetype, content)` {#pandoc.quoted}
+`Quoted (quotetype, content)`
 
-Creates a Quoted inline element given the quote type and
-quoted content.
+Creates a Quoted inline element given the quote type and quoted
+content.
 
 Parameters:
 
 `quotetype`
-:   type of quotes to be used
+:   type of quotes ([QuoteType]{unknown-type="QuoteType"})
 
 `content`
-:   inline content
+:   inlines in quotes ([Inlines])
 
-Returns: [Quoted](#type-quoted) object
+Returns:
+
+-   quoted element ([Inline])
 
-### `RawInline (format, text)` {#pandoc.rawinline}
+### RawInline {#pandoc.RawInline}
+
+`RawInline (format, text)`
 
 Creates a raw inline element
 
 Parameters:
 
 `format`
-:   format of the contents
+:   format of content (string)
 
 `text`
-:   string content
+:   string content (string)
 
-Returns: [RawInline](#type-rawinline) object
+Returns:
+
+-   raw inline element ([Inline])
 
-### `SmallCaps (content)` {#pandoc.smallcaps}
+### SmallCaps {#pandoc.SmallCaps}
+
+`SmallCaps (content)`
 
 Creates text rendered in small caps
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
-Returns: [SmallCaps](#type-smallcaps) object
+Returns:
 
-### `SoftBreak ()` {#pandoc.softbreak}
+-   new object ([Inline])
+
+### SoftBreak {#pandoc.SoftBreak}
+
+`SoftBreak ()`
 
 Creates a SoftBreak inline element.
 
-Returns: [SoftBreak](#type-softbreak) object
+Returns:
 
-### `Space ()` {#pandoc.space}
+-   soft break ([Inline])
+
+### Space {#pandoc.Space}
+
+`Space ()`
 
 Create a Space inline element
 
-Returns: [Space](#type-space) object
+Returns:
+
+-   new space ([Inline])
 
-### `Span (content[, attr])` {#pandoc.span}
+### Span {#pandoc.Span}
+
+`Span (content[, attr])`
 
 Creates a Span inline element
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
 `attr`
-:   additional attributes
+:   additional attributes ([Attr])
+
+Returns:
 
-Returns: [Span](#type-span) object
+-   [Span] object ([Inline])
 
-### `Str (text)` {#pandoc.str}
+### Str {#pandoc.Str}
+
+`Str (text)`
 
 Creates a Str inline element
 
 Parameters:
 
 `text`
-:   content
+:    (string)
+
+Returns:
 
-Returns: [Str](#type-str) object
+-   [Str] object ([Inline])
 
-### `Strikeout (content)` {#pandoc.strikeout}
+### Strikeout {#pandoc.Strikeout}
+
+`Strikeout (content)`
 
 Creates text which is struck out.
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
+
+Returns:
 
-Returns: [Strikeout](#type-strikeout) object
+-   new object ([Inline])
 
-### `Strong (content)` {#pandoc.strong}
+### Strong {#pandoc.Strong}
 
-Creates a Strong element, whose text is usually displayed in
-a bold font.
+`Strong (content)`
+
+Creates a Strong element, whose text is usually displayed in a
+bold font.
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
+
+Returns:
+
+-   new object ([Inline])
 
-Returns: [Strong](#type-strong) object
+### Subscript {#pandoc.Subscript}
 
-### `Subscript (content)` {#pandoc.subscript}
+`Subscript (content)`
 
 Creates a Subscript inline element
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
-Returns: [Subscript](#type-subscript) object
+Returns:
+
+-   new object ([Inline])
 
-### `Superscript (content)` {#pandoc.superscript}
+### Superscript {#pandoc.Superscript}
+
+`Superscript (content)`
 
 Creates a Superscript inline element
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
 
-Returns: [Superscript](#type-superscript) object
+Returns:
 
-### `Underline (content)` {#pandoc.underline}
+-   new object ([Inline])
+
+### Underline {#pandoc.Underline}
+
+`Underline (content)`
 
 Creates an Underline inline element
 
 Parameters:
 
 `content`
-:   inline content
+:   inline content ([Inlines])
+
+Returns:
 
-Returns: [Underline](#type-underline) object
+-   new object ([Inline])
 
-## Inlines
+### Inlines {#pandoc.Inlines}
 
-### `Inlines (inline_like_elements)` {#pandoc.inlines}
+`Inlines (inline_like_elements)`
 
-Converts its argument into an [Inlines][] list:
+Converts its argument into an [Inlines] list:
 
 -   copies a list of [Inline] elements into a fresh list; any
     string `s` within the list is treated as `pandoc.Str(s)`;
 -   turns a single [Inline] into a singleton list;
--   splits a string into `Str`-wrapped words, treating
-    interword spaces as `Space`s or `SoftBreak`s.
+-   splits a string into `Str`-wrapped words, treating interword
+    spaces as `Space`s or `SoftBreak`s.
 
 Parameters:
 
 `inline_like_elements`
-:   List where each element can be treated as an [Inline]
-    values, or just a single such value.
+:   List where each element can be treated as an [Inline] value,
+    or just a single such value. ([Inlines])
 
-Returns: [Inlines][] list
+Returns:
 
+-   list of inline elements ([Inlines])
 
-## Element components
+### Attr {#pandoc.Attr}
 
-### `Attr ([identifier[, classes[, attributes]]])` {#pandoc.attr}
+`Attr ([identifier[, classes[, attributes]]])`
 
-Create a new set of attributes (Attr).
+Create a new set of attributes
 
 Parameters:
 
 `identifier`
-:   element identifier
+:   element identifier (string\|table\|[Attr])
 
 `classes`
-:   element classes
+:   element classes ({string,\...})
 
 `attributes`
 :   table containing string keys and values
+    (table\|[AttributeList])
 
-Returns: [Attr](#type-attr) object
+Returns:
 
-### `Cell (blocks[, align[, rowspan[, colspan[, attr]]]])` {#pandoc.cell}
+-   new Attr object ([Attr])
+
+### Cell {#pandoc.Cell}
+
+`Cell (blocks[, align[, rowspan[, colspan[, attr]]]])`
 
 Create a new table cell.
 
 Parameters:
 
 `blocks`
-:   cell contents ([Blocks][])
+:   cell contents ([Blocks])
 
 `align`
-:   text alignment; defaults to `AlignDefault` (Alignment)
+:   text alignment; defaults to `AlignDefault` ([Alignment])
 
 `rowspan`
 :   number of rows occupied by the cell; defaults to `1`
-    (integer)
+    ([integer]{unknown-type="integer"})
 
 `colspan`
-:   number of columns spanned by the cell; defaults to `1`
-    (integer)
+:   number of columns occupied by the cell; defaults to `1`
+    ([integer]{unknown-type="integer"})
 
 `attr`
-:   cell attributes ([Attr](#type-attr))
+:   cell attributes ([Attr])
+
+Returns:
+
+-   new Cell object ([Cell])
+
+### AttributeList {#pandoc.AttributeList}
+
+`AttributeList (attribs)`
+
+Parameters:
+
+`attribs`
+:   an attribute list (table\|[AttributeList])
 
 Returns:
 
--   [Cell](#type-cell) object
+-   new AttributeList object ([AttributeList])
 
-### `Citation (id, mode[, prefix[, suffix[, note_num[, hash]]]])` {#pandoc.citation}
+### Citation {#pandoc.Citation}
+
+`Citation (id, mode[, prefix[, suffix[, note_num[, hash]]]])`
 
 Creates a single citation.
 
 Parameters:
 
 `id`
-:   citation identifier (like a bibtex key)
+:   citation ID (e.g. BibTeX key) (string)
 
 `mode`
-:   citation mode
+:   citation rendering mode
+    ([CitationMode]{unknown-type="CitationMode"})
 
 `prefix`
-:   citation prefix
+:    ([Inlines])
 
 `suffix`
-:   citation suffix
+:    ([Inlines])
 
 `note_num`
-:   note number
+:   note number ([integer]{unknown-type="integer"})
 
 `hash`
-:   hash number
+:   hash number ([integer]{unknown-type="integer"})
+
+Returns:
+
+-   new citation object ([Citation]{unknown-type="Citation"})
 
-Returns: [Citation](#type-citation) object
+### ListAttributes {#pandoc.ListAttributes}
 
-### `ListAttributes ([start[, style[, delimiter]]])` {#pandoc.listattributes}
+`ListAttributes ([start[, style[, delimiter]]])`
 
-Creates a set of list attributes.
+Creates a new ListAttributes object.
 
 Parameters:
 
 `start`
 :   number of the first list item
+    ([integer]{unknown-type="integer"})
 
 `style`
-:   style used for list numbering
+:   style used for list numbering (string)
 
 `delimiter`
-:   delimiter of list numbers
+:   delimiter of list numbers (string)
+
+Returns:
+
+-   new ListAttributes object ([ListAttributes])
 
-Returns: [ListAttributes](#type-listattributes) object
+### Row {#pandoc.Row}
 
-### `Row ([cells[, attr]])` {#pandoc.row}
+`Row ([cells[, attr]])`
 
 Creates a table row.
 
 Parameters:
 
 `cells`
-:   list of table cells in this row
+:   list of table cells in this row ({[Cell],\...})
 
 `attr`
-:   row attributes
+:   row attributes ([Attr])
 
-### `TableFoot ([rows[, attr]])` {#pandoc.tablefoot}
-
-Creates a table foot.
-
-Parameters:
+Returns:
 
-`rows`
-:   list of table rows
+-   new Row object ([Row])
 
-`attr`
-:   table foot attributes
+### TableFoot {#pandoc.TableFoot}
 
-### `TableHead ([rows[, attr]])` {#pandoc.tablehead}
+`TableFoot ([rows[, attr]])`
 
-Creates a table head.
+Creates a table foot.
 
 Parameters:
 
 `rows`
-:   list of table rows
+:   list of table rows ({[Row],\...})
 
 `attr`
-:   table head attributes
+:   table foot attributes ([Attr])
+
+Returns:
 
-## Legacy types
+-   new TableFoot object ([TableFoot])
 
-### `SimpleTable (caption, aligns, widths, headers, rows)` {#pandoc.simpletable}
+### TableHead {#pandoc.TableHead}
 
-Creates a simple table resembling the old (pre pandoc 2.10)
-table type.
+`TableHead ([rows[, attr]])`
+
+Creates a table head.
 
 Parameters:
 
-`caption`
-:   [Inlines][]
+`rows`
+:   list of table rows ({[Row],\...})
 
-`aligns`
-:   column alignments ([List] of [Alignments](#type-alignment))
+`attr`
+:   table head attributes ([Attr])
 
-`widths`
-:   column widths; a  ([List] of numbers)
+Returns:
 
-`headers`
-:   table header row ([List] of [Blocks][])
+-   new TableHead object ([TableHead])
 
-`rows`
-:   table rows ([List] of rows, where a row is a list
-    of [Blocks][])
+### SimpleTable {#pandoc.SimpleTable}
 
-Returns: [SimpleTable] object
+`SimpleTable (caption, align, widths, header, rows)`
 
 Usage:
 
@@ -3278,6 +3444,29 @@ Usage:
       rows
     )
 
+Parameters:
+
+`caption`
+:   table caption ([Inlines])
+
+`align`
+:   column alignments ({[Alignment],\...})
+
+`widths`
+:   relative column widths ({number,\...})
+
+`header`
+:   table header row ({[Blocks],\...})
+
+`rows`
+:   table rows ({{[Blocks],\...},\...})
+
+Returns:
+
+-   new SimpleTable object ([SimpleTable])
+
+<!-- END: AUTOGENERATED CONTENT -->
+
 ## Constants
 
 [`AuthorInText`]{#pandoc.authorintext}
@@ -6523,13 +6712,29 @@ Returns:
 
 <!-- BEGIN: GENERATED REFERENCE LINKS -->
 
-  [Block]: #type-block
   [Blocks]: #type-blocks
-  [Inline]: #type-inline
-  [Inlines]: #type-inlines
+  [Meta]: #type-meta
   [Pandoc]: #type-pandoc
-  [Table]: #type-table
+  [Inlines]: #type-inlines
+  [MetaValue]: #type-metavalue
+  [Block]: #type-block
+  [Attr]: #type-attr
+  [Figure]: #type-figure
+  [Caption]: #type-caption
+  [ListAttributes]: #type-listattributes
+  [ColSpec]: #type-colspec
+  [TableHead]: #type-tablehead
+  [TableBody]: #type-tablebody
+  [TableFoot]: #type-tablefoot
+  [Inline]: #type-inline
+  [Span]: #type-span
+  [Str]: #type-str
+  [AttributeList]: #type-attributes
+  [Alignment]: #type-alignment
+  [Cell]: #type-cell
+  [Row]: #type-row
   [SimpleTable]: #type-simpletable
+  [Table]: #type-table
   [Version]: #type-version
   [`list`]: #pandoc.mediabag.list
   [WriterOptions]: #type-writeroptions
@@ -6538,6 +6743,5 @@ Returns:
   [ChunkedDoc]: #type-chunkeddoc
   [Doc]: #type-doc
   [Template]: #type-template
-  [Meta]: #type-meta
   [zip.Entry]: #type-pandoc.zip.Entry
   [zip.Archive]: #type-pandoc.zip.Archive