1
- name: tbl-cap
2
  schema:
3
    maybeArrayOf: string
4
  description: Table caption
5

6
- name: tbl-subcap
7
  schema:
8
    anyOf:
9
      - enum: [true]
10
      - maybeArrayOf: string
11
  description: Table subcaptions
12

13
- name: tbl-colwidths
14
  tags:
15
    contexts: [document-tables]
16
    engine: [knitr, jupyter]
17
    formats: [$pdf-all, $html-all]
18
  schema:
19
    anyOf:
20
      - boolean
21
      - enum: [auto]
22
      - arrayOf: number
23
  description:
24
    short: "Apply explicit table column widths"
25
    long: |
26
      Apply explicit table column widths for markdown grid tables and pipe
27
      tables that are more than `columns` characters wide (72 by default). 
28

29
      Some formats (e.g. HTML) do an excellent job automatically sizing
30
      table columns and so don't benefit much from column width specifications.
31
      Other formats (e.g. LaTeX) require table column sizes in order to 
32
      correctly flow longer cell content (this is a major reason why tables 
33
      > 72 columns wide are assigned explicit widths by Pandoc).
34

35
      This can be specified as:
36

37
      - `auto`: Apply markdown table column widths except when there is a
38
        hyperlink in the table (which tends to throw off automatic
39
        calculation of column widths based on the markdown text width of cells).
40
        (`auto` is the default for HTML output formats)
41

42
      - `true`: Always apply markdown table widths (`true` is the default
43
        for all non-HTML formats)
44

45
      - `false`: Never apply markdown table widths.
46

47
      - An array of numbers (e.g. `[40, 30, 30]`): Array of explicit width percentages.
48

49
- name: html-table-processing
50
  schema:
51
    enum: [none]
52
  description: If `none`, do not process raw HTML table in cell output and leave it as-is
53

54