@@ -1610,9 +1610,14 @@ Four kinds of tables may be used. The first three kinds presuppose the use of
1610a fixed-width font, such as Courier. The fourth kind can be used with
1610a fixed-width font, such as Courier. The fourth kind can be used with
1611proportionally spaced fonts, as it does not require lining up columns.
1611proportionally spaced fonts, as it does not require lining up columns.
1613−### Simple tables ###
1613+### Extension: `table_captions` ###
1615+A caption may optionally be provided with all 4 kinds of tables (as
1616+illustrated in the examples below). A caption is a paragraph beginning
1617+with the string `Table:` (or just `:`), which will be stripped off.
1618+It may appear either before or after the table.
1615−#### Extension: `simple_tables`, `table_captions` ####
1620+### Extension: `simple_tables` ###
1617Simple tables look like this:
1622Simple tables look like this:
@@ -1641,10 +1646,7 @@ to the dashed line below it:[^4]
1641 [Markdown discussion list](http://six.pairlist.net/pipermail/markdown-discuss/2005-March/001097.html).
1646 [Markdown discussion list](http://six.pairlist.net/pipermail/markdown-discuss/2005-March/001097.html).
1643The table must end with a blank line, or a line of dashes followed by
1648The table must end with a blank line, or a line of dashes followed by
1644−a blank line. A caption may optionally be provided (as illustrated in
1649+a blank line.
1645−the example above). A caption is a paragraph beginning with the string
1646−`Table:` (or just `:`), which will be stripped off. It may appear either
1647−before or after the table.
1649The column headers may be omitted, provided a dashed line is used
1651The column headers may be omitted, provided a dashed line is used
1650to end the table. For example:
1652to end the table. For example:
@@ -1659,9 +1661,7 @@ When headers are omitted, column alignments are determined on the basis
1659of the first line of the table body. So, in the tables above, the columns
1661of the first line of the table body. So, in the tables above, the columns
1660would be right, left, center, and right aligned, respectively.
1662would be right, left, center, and right aligned, respectively.
1662−### Multiline tables ###
1664−#### Extension: `multiline_tables`, `table_captions` ####
1664+### Extension: `multiline_tables` ###
1666Multiline tables allow headers and table rows to span multiple lines
1666Multiline tables allow headers and table rows to span multiple lines
1667of text (but cells that span multiple columns or rows of the table are
1667of text (but cells that span multiple columns or rows of the table are
@@ -1711,9 +1711,7 @@ It is possible for a multiline table to have just one row, but the row
1711should be followed by a blank line (and then the row of dashes that ends
1711should be followed by a blank line (and then the row of dashes that ends
1712the table), or the table may be interpreted as a simple table.
1712the table), or the table may be interpreted as a simple table.
1716−#### Extension: `grid_tables`, `table_captions` ####
1714+### Extension: `grid_tables` ###
1718Grid tables look like this:
1716Grid tables look like this:
@@ -1737,9 +1735,7 @@ columns or rows. Grid tables can be created easily using [Emacs table mode].
1738 [Emacs table mode]: http://table.sourceforge.net/
1736 [Emacs table mode]: http://table.sourceforge.net/
1742−#### Extension: `pipe_tables`, `table_captions` ####
1738+### Extension: `pipe_tables` ###
1744Pipe tables look like this:
1740Pipe tables look like this:
@@ -1749,7 +1745,7 @@ Pipe tables look like this:
1749 | 123 | 123 | 123 | 123 |
1745 | 123 | 123 | 123 | 123 |
1750 | 1 | 1 | 1 | 1 |
1746 | 1 | 1 | 1 | 1 |
1752− : Demonstration of simple table syntax.
1748+ : Demonstration of pipe table syntax.
1754The syntax is [the same as in PHP markdown extra]. The beginning and
1750The syntax is [the same as in PHP markdown extra]. The beginning and
1755ending pipe characters are optional, but pipes are required between all
1751ending pipe characters are optional, but pipes are required between all
@@ -1785,8 +1781,8 @@ The difference is that `+` is used instead of `|`. Other orgtbl features
1785are not supported. In particular, to get non-default column alignment,
1781are not supported. In particular, to get non-default column alignment,
1786you'll need to add colons as above.
1782you'll need to add colons as above.
1788−Title block
1784+Metadata blocks
1789−-----------
1785+---------------
1791### Extension: `pandoc_title_block` ###
1787### Extension: `pandoc_title_block` ###
@@ -1864,9 +1860,6 @@ will also have "Pandoc User Manuals" in the footer.
1865will also have "Version 4.0" in the header.
1861will also have "Version 4.0" in the header.
1870### Extension: `yaml_metadata_block` ###
1863### Extension: `yaml_metadata_block` ###
1872A YAML metadata block is a valid YAML object, delimited by a line of three
1865A YAML metadata block is a valid YAML object, delimited by a line of three
@@ -2386,9 +2379,7 @@ The link text will be used as the image's alt text:
2387 [movie reel]: movie.gif
2380 [movie reel]: movie.gif
2389−### Pictures with captions ###
2391−#### Extension: `implicit_figures` ####
2382+### Extension: `implicit_figures` ###
2393An image occurring by itself in a paragraph will be rendered as
2384An image occurring by itself in a paragraph will be rendered as
2394a figure with a caption.[^5] (In LaTeX, a figure environment will be
2385a figure with a caption.[^5] (In LaTeX, a figure environment will be