@@ -356,6 +356,23 @@ header when requesting a document from a URL:
356356 `slidy`, `slideous`, or `s5` directory
357357 placed in this directory will override pandoc's normal defaults.
358358
359+`-d` *FILE*, `--defaults=`*FILE*
360+
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
369+ file format.
370+
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.
375+
359376`--bash-completion`
360377
361378: Generate a bash completion script. To enable bash completion
@@ -1402,6 +1419,92 @@ Nonzero exit codes have the following meanings:
14021419 99 PandocResourceNotFound
14031420----- ------------------------------------
14041421
1422+# Default files
1423+
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:
1427+
1428+``` yaml
1429+abbreviations: null
1430+ascii: false
1431+cite-method: citeproc
1432+columns: 72
1433+css:
1434+ - my.css
1435+data-dir: data
1436+default-image-extension: ".jpg"
1437+dpi: 96
1438+dump-args: false
1439+email-obfuscation: none
1440+eol: Native
1441+epub-chapter-level: 1
1442+epub-cover-image: null
1443+epub-fonts: []
1444+epub-metadata: metadata.xml
1445+epub-subdirectory: EPUB
1446+extract-media: media
1447+fail-if-warnings: false
1448+file-scope: false
1449+filters:
1450+ - pandoc-citeproc
1451+from: markdown+emoji
1452+highlight-style: pygments
1453+html-math-method:
1454+ method: mathjax
1455+ url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
1456+html-qtags: false
1457+identifier-prefix: ""
1458+ignore-args: false
1459+include-after-body: []
1460+include-before-body: []
1461+include-in-header: []
1462+incremental: false
1463+indented-code-classes: []
1464+input-files: []
1465+ipynb-output: best
1466+listings: false
1467+log-file: null
1468+metadata: {}
1469+metadata-file: []
1470+number-offset: [0,0,0,0,0,0]
1471+number-sections: false
1472+output-file: null
1473+pdf-engine: null
1474+pdf-engine-args: []
1475+preserve-tabs: false
1476+reference-doc: null
1477+reference-links: false
1478+reference-location: end-of-document
1479+request-headers: []
1480+resource-path: [".", "../foo"]
1481+section-divs: false
1482+self-contained: false
1483+setext-headers: true
1484+shift-heading-level-by: 0
1485+slide-level: null
1486+standalone: false
1487+strip-comments: false
1488+strip-empty-paragraphs: false
1489+syntax-definitions: []
1490+tab-stop: 4
1491+table-of-contents: false
1492+template: letter
1493+title-prefix: null
1494+to: null
1495+toc-depth: 3
1496+top-level-division: default
1497+trace: false
1498+track-changes: accept-changes
1499+variables:
1500+ - documentclass: book
1501+ - classoptions:
1502+ - twosides
1503+ - draft
1504+verbosity: WARNING
1505+wrap-text: wrap-auto
1506+```
1507+
14051508# Templates
14061509
14071510When the `-s/--standalone` option is used, pandoc uses a template to