@@ -264,6 +264,34 @@ Use normal latex citation commands like `\cite{x}` or
264264[org-ref]: https://github.com/jkitchin/org-ref
265265[John Kitchen]: https://kitchingroup.cheme.cmu.edu/
266266
267+Tables
268+======
269+
270+Pandoc supports normal org tables (sometimes calles "pipe tables")
271+and grid tables (tables created by [table.el]).
272+
273+Column widths
274+-------------
275+
276+Org mode tables don't allow line-breaks within cells, and lines
277+which contain text can get very long. This often leads to tables
278+which run off the page when exporting, especially when exporting
279+to PDF via LaTeX. Overlong lines in the source text are this is
280+usually hidden by setting a [column width], but the default Emacs
281+exporters ignore that setting. Pandoc deviates from Emacs's
282+behavior and uses this information to resize the table columns
283+when exporting.
284+
285+Limitations
286+-----------
287+
288+There is no support yet for cells spanning multiple columns or
289+rows. The table.el grid tables allows rowspans and colspans and so
290+does pandoc's internal structure since 2.10, but the parser has
291+not been updated yet.
292+
293+[table.el]: http://table.sourceforge.net/
294+[column width]: https://orgmode.org/manual/Column-Width-and-Alignment.html
267295
268296Emphasis rules
269297==============