1
- name: to
2
  alias: writer
3
  schema: string
4
  default: html
5
  hidden: true
6
  description:
7
    short: "Format to write to (e.g. html)"
8
    long: |
9
      Format to write to. Extensions can be individually enabled or disabled by appending +EXTENSION or -EXTENSION to the format name (e.g. gfm+footnotes)
10

11
- name: input-file
12
  schema: path
13
  hidden: true
14
  description: "Input file to read from"
15

16
- name: input-files
17
  schema:
18
    arrayOf: path
19
  hidden: true
20
  description: "Input files to read from"
21

22
- name: defaults
23
  schema:
24
    arrayOf: path
25
  hidden: true
26
  description: "Include options from the specified defaults files"
27

28
- name: variables
29
  schema: object
30
  hidden: true
31
  description: "Pandoc metadata variables"
32

33
- name: metadata
34
  schema: object
35
  hidden: true
36
  description: "Pandoc metadata variables"
37

38
- name: request-headers
39
  schema:
40
    ref: pandoc-format-request-headers
41
  hidden: true
42
  description: "Headers to include with HTTP requests by Pandoc"
43

44
- name: trace
45
  schema: boolean
46
  default: false
47
  description: "Display trace debug output."
48

49
- name: fail-if-warnings
50
  schema: boolean
51
  default: false
52
  description: "Exit with error status if there are any warnings."
53

54
- name: dump-args
55
  schema: boolean
56
  default: false
57
  hidden: true
58
  description: "Print information about command-line arguments to *stdout*, then exit."
59

60
- name: ignore-args
61
  schema: boolean
62
  default: false
63
  hidden: true
64
  description: "Ignore command-line arguments (for use in wrapper scripts)."
65

66
- name: file-scope
67
  schema: boolean
68
  hidden: true
69
  default: false
70
  description: "Parse each file individually before combining for multifile documents."
71

72
- name: data-dir
73
  schema: path
74
  hidden: true
75
  description: "Specify the user data directory to search for pandoc data files."
76

77
- name: verbosity
78
  schema:
79
    enum: [ERROR, WARNING, INFO]
80
  default: WARNING
81
  hidden: true
82
  description: "Level of program output (`INFO`, `ERROR`, or `WARNING`)"
83

84
- name: log-file
85
  hidden: true
86
  schema: path
87
  description: "Write log messages in machine-readable JSON format to FILE."
88

89
- name: track-changes
90
  tags:
91
    formats: [docx]
92
  hidden: true
93
  schema:
94
    enum: [accept, reject, all]
95
  default: accept
96
  description:
97
    short: |
98
      Specify what to do with insertions, deletions, and comments produced by 
99
      the MS Word “Track Changes” feature.
100
    long: |
101
      Specify what to do with insertions, deletions, and comments
102
      produced by the MS Word "Track Changes" feature.  
103

104
      - `accept` (default): Process all insertions and deletions.
105
      - `reject`: Ignore them.
106
      - `all`: Include all insertions, deletions, and comments, wrapped
107
        in spans with `insertion`, `deletion`, `comment-start`, and
108
        `comment-end` classes, respectively. The author and time of
109
        change is included. 
110

111
      Notes:
112

113
      - Both `accept` and `reject` ignore comments.
114

115
      - `all` is useful for scripting: only
116
        accepting changes from a certain reviewer, say, or before a
117
        certain date. If a paragraph is inserted or deleted,
118
        `track-changes: all` produces a span with the class
119
        `paragraph-insertion`/`paragraph-deletion` before the
120
        affected paragraph break. 
121

122
      - This option only affects the docx reader.
123

124
- name: keep-source
125
  tags:
126
    formats: [$html-doc]
127
  schema: boolean
128
  default: false
129
  hidden: true
130
  description:
131
    short: "Embed the input file source code in the generated HTML"
132
    long: |
133
      Embed the input file source code in the generated HTML. A hidden div with 
134
      class `quarto-embedded-source-code` will be added to the document. This
135
      option is not normally used directly but rather in the implementation
136
      of the `code-tools` option.
137

138
- name: keep-hidden
139
  tags:
140
    formats: [$html-doc]
141
  schema: boolean
142
  default: false
143
  hidden: true
144
  description: "Keep hidden source code and output (marked with class `.hidden`)"
145

146
- name: prefer-html
147
  tags:
148
    formats: [$markdown-all]
149
  schema: boolean
150
  default: false
151
  hidden: true
152
  description:
153
    short: "Generate HTML output (if necessary) even when targeting markdown."
154
    long: |
155
      Generate HTML output (if necessary) even when targeting markdown. Enables the 
156
      embedding of more sophisticated output (e.g. Jupyter widgets) in markdown.
157

158
- name: output-divs
159
  schema: boolean
160
  default: true
161
  hidden: true
162
  description: |
163
    Indicates that computational output should not be written within divs. 
164
    This is necessary for some formats (e.g. `pptx`) to properly layout
165
    figures.
166

167
- name: merge-includes
168
  schema: boolean
169
  default: true
170
  hidden: true
171
  description: |
172
    Disable merging of string based and file based includes (some formats, 
173
    specifically ePub, do not correctly handle this merging)
174

175