@@ -356,6 +356,23 @@ header when requesting a document from a URL:
356 `slidy`, `slideous`, or `s5` directory
356 `slidy`, `slideous`, or `s5` directory
357 placed in this directory will override pandoc's normal defaults.
357 placed in this directory will override pandoc's normal defaults.
359+`-d` *FILE*, `--defaults=`*FILE*
361+: Specify a set of default option settings. *FILE* is a YAML
362+ file whose fields correspond to command-line option
363+ settings. All options for document conversion, including input
364+ and output files, can be set using a defaults file. The file will
365+ be searched for first in the working directory, and then in
366+ the `defaults` subdirectory of the user data directory
367+ (see `--data-dir`). The `.yaml` extension may be omitted.
368+ See the section [Default files] for more information on the
371+ If a defaults file is used, its defaults will override
372+ any options that have been previously specified on the
373+ command line, and they may be overridden by subsequent
374+ options on the command line.
359`--bash-completion`
376`--bash-completion`
361: Generate a bash completion script. To enable bash completion
378: Generate a bash completion script. To enable bash completion
@@ -1402,6 +1419,92 @@ Nonzero exit codes have the following meanings:
1402 99 PandocResourceNotFound
1419 99 PandocResourceNotFound
1403----- ------------------------------------
1420----- ------------------------------------
1424+The `--defaults` option may be used to specify a package
1425+of options. Here is a sample defaults file demonstrating all of
1426+the fields that may be used:
1431+cite-method: citeproc
1436+default-image-extension: ".jpg"
1439+email-obfuscation: none
1441+epub-chapter-level: 1
1442+epub-cover-image: null
1444+epub-metadata: metadata.xml
1445+epub-subdirectory: EPUB
1446+extract-media: media
1447+fail-if-warnings: false
1451+from: markdown+emoji
1452+highlight-style: pygments
1455+ url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
1457+identifier-prefix: ""
1459+include-after-body: []
1460+include-before-body: []
1461+include-in-header: []
1463+indented-code-classes: []
1470+number-offset: [0,0,0,0,0,0]
1471+number-sections: false
1475+preserve-tabs: false
1477+reference-links: false
1478+reference-location: end-of-document
1480+resource-path: [".", "../foo"]
1482+self-contained: false
1483+setext-headers: true
1484+shift-heading-level-by: 0
1487+strip-comments: false
1488+strip-empty-paragraphs: false
1489+syntax-definitions: []
1491+table-of-contents: false
1496+top-level-division: default
1498+track-changes: accept-changes
1500+ - documentclass: book
1505+wrap-text: wrap-auto
1405# Templates
1508# Templates
1407When the `-s/--standalone` option is used, pandoc uses a template to
1510When the `-s/--standalone` option is used, pandoc uses a template to